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PREFACE 


The Perkin-Elmer Multi-Terminal Monitor (MTM) Reference Manual is 
written for the MTM user and can also be helpful to the system 
operator and system programmer. 


Chapter 1 is a general description of the MTM system containing 
information on MTM system requirements, MTM features and various 
conventions. Chapter 2 describes MTM user commands. Chapter 3 
describes MTM to non-MTM task interfaces that allow users to 
transfer control of their terminal between MTM and other non-MITM 
tasks (HASP, ITC/Reliance, Foreground) and return to MTM in an 
orderly fashion. Chapter 4 describes the program development 
commands. Chapter 5 describes batch processing under MTM. 
Chapter 6 describes the command substitution system (CSS) and the 
CSS commands. Chapter 7 describes spooling and briefly describes 
the two spoolers (O0S/32 and SPL/32) available to users of 0OS/32 
and MTM. 


Appendix A summarizes the MTM user commands. Appendix B is a 
summary of the program development commands. Appendix C 
summarizes the CSS commands. Appendix D is an MTM command 
message summary. Appendix E iS a summary of CSS messages. 


Appendix F is a summary of program development command messages. 
Appendix G is a summary of MTM to non-MTM task interface 
messages. Appendix H is a control summary for the bidirectional 
input/output control (BIOC) CRT driver. 


Revision 02 of this manual adds MTM information specific to the 


Model 3200MPS Processor. This information is reflected in 
changes to the DISPLAY ACCOUNTING, $JOB, OPTIONS and SIGNON 
commands . System output in response to the SIGNOFF command has 
been revised. An interactive signon procedure and a brief 


description of the load leveling executive (LLE) has also been 
included. 


Changes affecting MTM users for all Perkin-Elmer Series 3200 
Processors are also included in this revision. These changes 
affect the assignment of default data and index block sizes for 
INDEX and NB file types. The affected commands are ALLOCATE and 
XALLOCATE, SPOOLFILE and TEMPFILE. A new file type, LR, which 
specifies a long record file, has been added to these commands. 


This manual is intended for use with the 0OS/32 RO07.2 software 
release and higher. 


For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
GENERAL DESCRIPTION 


1.1 INTRODUCTION 


The multi-terminal monitor (MTM) permits several terminal users 
to share system resources. Each user perceives that a computer 
is at his disposal. 


Concurrent access from on-line terminals is useful during 
application task development, because it reduces turnaround time 
and it can be used to extend the type of data processing at an 


installation. Using the system-supplied interactive software 
means that editing, task development and documentation can be 
done simultaneously. If the system-supplied interactive tasks 


are supplemented by customer-written tasks, MTM application 
becomes limitless, supporting a mixture of terminal users such as 
clerks, software development and operations personnel. 

1.2 MULTI-TERMINAL MONITOR (MTM) OPERATION 

Like all general purpose, multi-access, time-sharing systems, MTM 
requires operations involvement from the installation using it. 
This involvement includes those functions that accompany MTM when 
it is tailored to a specific installation, along with dynamic 
functions performed when MTM is operating. 


Examples of the MIM tailoring functions are: 


e Cataloguing authorized users 
e System generation (sysgen) 


e Establishing an installation's procedures 
Examples of dynamic functions are: 


e System console control 
e Peripheral device supervision 


e Spooled output dissemination 


48-043 FOO RO2 1-1 


Generally, tailoring functions are performed and maintained by 
the customer's system support group responsible for making 
computing facilities available to system users. The dynamic 
functions are performed by a system operator during system 
operation and are distinct from those functions performed by 
terminal users. 


The system operator can perform all the functions described in 
the OS/32 Operator Reference Manual, together with operator 
functions required to administer MTM. At any time, the system 
operator can initiate and control multiple foreground tasks and 
one background task while operating MTM. 


1.3 USER INFORMATION 


Under MTM control, a terminal user can: 


@e load and execute interactive tasks, 

@ submit multiple batch job requests, 

@ perform program development, 

@® perform program debugging, 

@® create, edit and manipulate files, 

@ build, modify and execute command streams, 
@® use spooling functions, 

@ communicate with other terminal users, and 


@ communicate with the system operator. 


A terminal user is either interacting with MIM itself via 
commands or interacting with tasks supplied with the system or 
developed by the installation. All of the vendor-supplied 
language translators can be operated as interactive tasks by a 
terminal user. Additionally, a terminal user can use the 
vendor-supplied support software programs such as: 0OS/32 Edit, 
OS/32 COPY, and OS/32 AIDS. It is the MTM software that performs 
multiple on-line accessibility; e.g., time sharing, resource 
management, batch scheduling, etc. 


The terminal user can be local or remote. The interactive 
terminals for local users are directly connected to the computer 
and do not require telecommunication devices. Interactive 
terminals for remote users require connection via 
telecommunication equipment and data communications software. 
Basic data communications support both dedicated and dial-up 
telecommunication terminals. 
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1.3.1 Multi-Terminal Monitor (MTM) Devices 
The following devices can be used at any local or _ remote 
installation: 

@® Model 550B Video Display Unit (VDU) 

@ Model 1100 VDU 

@ Model 1200 VDU 

@ Model 1250 VDU 

e Model 1251 VDU 

@ Model 6100 VDU 

@e Perkin-Elmer SIGMA 10 terminal 

@ M33 Teletype 

e M35 Teletype 

e Nonediting VDU 

e Carousel 


e Carousel 300 and 300 EFC 


1.3.2 Authorization 


The user must be authorized to use MTM facilities. During the 
signon procedure, the user must supply an account number anda 
password that were previously catalogued within an MT™ file 
called the authorized user file (AUF). The AUF is updated and 
maintained by an MTM-supplied task that can be initiated only by 
the system operator. The terminal user can then interact with 
MTM from a terminal. 


1.3.3 Privileged Users 


A variety of new capabilities, called privileges, are now 
available to the MTM user. These privileges are associated with 
an account through the AUF Utility and are, thereafter, available 
to any user that signs on to that account. For the purpose of 
delineation throughout the remainder of this manual, any user 
that is signed on to an account that has any or all of these new 
capabilities enabled is called a privileged user. 
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In addition to all standard MTM capabilities, privileged users 
can have extended MIM capabilities such as: 


e displaying all jobs in the batch queue, 


@ moving between private accounts without mow sng passwords (SET 
PRIVATE command), 


e changing group account numbers (SET GROUP command), 


e setting the priority of a subsequently loaded task via a 
private command substitution system (CSS) (PRIOR command), 


e interfacing with a HASP protocol and returning to MTM control 
as desired ($HSP), and 


e interfacing with a foreground task from an MTM terminal and 
returning to MTM control as desired ($FRGND). 


For information on the specific privileges available through MTM 
and the procedures’ for enabling these privileges on an account 
basis, see the 0S/32 Multi-Terminal Monitor (MTM) System Planning 
and Operator Reference Manual. 


1.3.4 Transmitting Messages 


MTM can transmit messages between terminal users, between a 
terminal user and the system operator, and from the system 
operator to all or designated terminal users. 


1.3.5 Number of Terminal Users 


An installation can have up to 64 terminal users or 64 concurrent 
batch streams. The system can support up to 64 terminal users 
and batch streams in any combination. 


1.4 MULTI-TERMINAL MONITOR (MTM) SUBTASK ENVIRONMENTS 


The MIM terminal user controls a single task at the terminal and 
has the ability to run jobs through batch streams. Using the 
facilities provided by MTM, the user can load a task, start the 
task and interact with the task during its execution. Any user 
task (u-task) controlled through MIM is processed as a subtask of 
MTM. Both batch and interactive environments are available to 
MTM subtasks. For the sake of simplicity, subtasks will be 
referred to as tasks through the remainder of this manual. MTM 
provides interactive and batch user environments. 


In an interactive environment, the user has the ability to 


interact with a task via the terminal. In this environment, 
a dialogue is carried on between the user and the task. 


1-4 48-043 FOO RO2 


The interactive task receives user commands and processes’ them. 
Only one interactive task at a time can be initiated by each MTM 
terminal but all interactive tasks initiated by MTM terminal 
users are executed concurrently. During interactive task 
execution, a terminal user can direct a command to the MTM and 
can receive a response from MTM itself. 


In a batch environment, a number of jobs are run under a full set 
of automated procedures. Once a batch job is accepted for 
execution, no further interaction takes place with the initiating 
terminal user. Requests for multiple batch jobs can be submitted 
by a user and the same terminal can be used to initiate an 
interactive task. | 


Unlike interactive tasks, requests for batch jobs will not 
necessarily be initiated immediately to MTM. Instead, batch jobs 
are queued and then the queue of submitted batch jobs awaiting 
execution is serviced by MTM. The number of batch jobs that can 
be executing concurrently is specified by the system operator. 


A terminal user can request one or more batch jobs to be run. 
MTM maintains a queue of submitted batch jobs and concurrently 
processes a number of batch jobs specified during MIM system 
start-up. A terminal user can monitor the progress of a batch 
job by interrogating the MTM batch queue. The returned status 
will be either: . 


AWAITING EXECUTION 
or EXECUTING 


If a job has already completed execution, the returned status 
will be: 


NO JOBS FOUND 


1.4.1 Multi-Terminal Monitor (MTM) Terminal Modes 


An active terminal is in one of six terminal modes. The current 
mode of the terminal determines which, if any, MTM terminal 
commands can be accepted. Thus, it is important for the terminal 
user to be aware of the current mode of the terminal. The user 
terminal is defined to be in one of the following six modes: 


@e Command mode: No task is loaded, a CSS procedure is not 
executing, and BUILD is not in effect. All nontask-related 
commands are accepted. An asterisk (*) is the default prompt 
displayed in this mode. 
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@ Task-loaded mode: The task is loaded but it is not started, 
or the task is paused. An asterisk is the default prompt 
displayed in this mode. 


@ Task-executing mode: A task is started and executing. If 
started from a CSS, CSS mode is suspended. A hyphen (-) is 
the default prompt displayed in this mode. If an interactive 
task was started and data input is requested by the task, then 
a greater than character (>) is the default prompt displayed 
to the terminal user. 


e CSS mode: A CSS procedure is being built or executed. A 
hyphen is’ the default prompt displayed in this mode. When a 
CSS terminates, the terminal returns to command mode and an 
asterisk prompt is output. When BUILD is in effect, a B> is 
the default prompt displayed. 


@ Foreground task mode: The terminal is transferred to the 
control of a foreground task. When the foreground task is 
completed, the terminal returns control to MTM. MTM commands 
are not recognized when in the foreground task mode. 


@ HASP interface mode: The terminal is interfaced with a HASP 
task. The HASP mode prompt is a quotation mark ("). All 
commands entered while in this mode are sent to the specified 
HASP task. 


1.4.2 Interactive Task to Terminal Mode 


When a task issues a supervisor call 1 (SVC1) input/output (I/0) 
operation to an active terminal that is in task-executing mode 
and a previous I/O operation to that terminal is still pending, 
MTM treats the I/O as a wait operation. This information is not 
vital for tasks that perform SVCl wait I/O, but users with tasks 
that issue SVCl proceed I/O (read or write) should be aware that 
MTM suspends the task until the I/O is completed. MTM then posts 
an SVCl proceed I/O completion trap on the task's task queue and 
allows the task to continue. Completion trap posting occurs only 
if the appropriate bit is set in the task status word (TSW). 


1.5 MULTI-TERMINAL MONITOR (MTM) IN A MULTIPROCESSOR ENVIRONMENT 


The load leveling executive (LLE) feature of MTM is designed to 
optimize overall system performance in a multiprocessor 
environment on a Model 3200MPS System. 


The Model 3200MPS System includes a central processing unit. (CPU) 
and up to nine auxiliary processing units (APUs). MIM subtasks 
are queued for execution on either the CPU ready queue or APU 
queue 0. The ready queve is serviced by the CPU alone, while 
queue O is serviced by assigned APUs and the CPU when its ready 
queue is empty. 
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Maximum processing power is available for the tasks on queue 0; 
however, all operating system services (SVC calls, trap and fault 
handling, etc.) are performed by the CPU. LLE optimizes MTM 
subtask traffic between the two queues by directing 
service-intensive tasks to the CPU ready queue and 
computation-intensive tasks to queue 0, depending on the _ task's 
run-time behavior. 


Load-leveling is performed only when the LLE is enabled and then 
only for those tasks, including executive tasks (e-tasks) and 
diagnostic tasks (d-tasks), for which the logical processing unit 
(LPU) is equal to zero. 


NOTE 
Tasks loaded with an LPU number other 
than zero and without SVC6 control 


privilege, are reset to LPU number zero 
(see Section 2.30). 


1.6 LOADING A TASK 

The dynamic nature of OS/32 memory management guarantees loading 
of any size task unless the task is greater than the available 
task memory. If not enough memory is free to load a task, then 
some other task is temporarily rolled out if roll support is 
included in the operating system at sysgen. If MTM is sysgened 
with roll influence enabled, then MTM continually monitors the 
state of the roll queue to ensure that rolled out tasks are given 
the opportunity to be rolled back in. MTM ensures equity for all 
its terminal operators by assigning all the interactive tasks 
equal priority. Batch tasks can have user-assigned priorities. 
1.7 MULTI-TERMINAL MONITOR (MIM) SPECIAL FEATURES 

The following features are designed to make MTM easier and more 
efficient to use: 

e css 

e Help Facility 

@ Program development commands 

@e Spooling 

e Security and access protection of disks 


e Signon CSS 
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1.7.1 Command Substitution System (CSS) 


A terminal user can build a command file on a disk. Once built, 
a simple directive to MTM will cause MIM to obtain its directives 
from the command file. When invoking the command file, the 
terminal user can supply parameters to the command file that can 
be used to dynamically modify command execution. Therefore, a 
single terminal input can easily initiate complex operations. 


1.7.2 The Help Facility 


The Help Facility provides a user on-line access to documentation 
for MTM and program development commands. This information is 
obtained by entering the HELP command (see Section 2.28). 


1.7.3 Program Development Commands 


The program development commands are an integrated set of 
standard CSS procedures that perform two major functions: 


@® maintain information that remains constant throughout a 
development effort, and 


@ keep files current throughout a development effort in terms of 
checking source, object and image modules to ensure that their 
dates are current. 


1.7.4 Spooling 


Both input and output spooling are provided for terminal users. 
Tasks never need to be delayed waiting for card readers, card 
punching or line printing; a batch job can be submitted via the 
spooler. The job runs unattended and output goes to the spooler. 


1.7.5 Security and Access Protection of Disks 


Privately owned disks can be marked on as restricted by the 
system operator to offer an MTM user complete security and access 
protection of files. The owner of the disk can restrict or 
enable access of the disk to other MTM users, the system operator 
and non-MTM tasks. 
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1.7.6 Signon Command Subsitution System (CSS) 

MTM users can build a special CSS file, USERINIT.CSS, within 
their private accounts. This CSS file can contain commands to 
load and start a terminal session, assign logical units, and 
specify a language environment. At signon time, MTM searches all 
on-line disks within the user's’ private account for the file 
USERINIT.CSS and automatically executes it. If no USERINIT.CSS 
file is found within the user's’ private account, the system 
account is searched. 

1.8 CONVENTIONS 


These conventions used by MTM are detailed in the _ following 
sections: 


@® Prompt 

e Terminal 

e Command 

e Statement syntax 

e File 

1.8.1 Prompt Conventions 

A prompt is output to a terminal device to indicate that the MTM 


system is ready to accept input from the user. The default 
prompts displayed on the terminal devices are shown in Table 1-1. 


TABLE 1-1 MTM PROMPT CONVENTIONS 


ee ee ee ee nt es ee cme me cee cms tt meet em cee ite tm omens ge no om em eam ea ee ee es ees ee ee A ee mm mes es ee eos me a ee nee i es ems ee a Oe ee ee 


PROMPT USE 

“* | Indicates MTM system is ready to accept a command. 
> Indicates a request for input data. 
B> Indicates a request for input data to be copied 


to a BUILD file. 


Indicates that the system is ready to accepta 
command while an interactive task is active or a 
SS is running. A new CSS cannot be initiated at 
this time. A user can instruct MTM to. suppress or 
enable the appearance of this prompt while an inter- 
active task is running, but not while CSS is running. 


Indicates that the terminal is in HASP mode. 


re we cee re ee me ee ee ee ee eee ee ee er ee ee Ee ee eee eee ee ee ee ee ee ee ee omen ee ee ee ee ee ee ee ee ee ee re ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 
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1.8.2 Terminal Conventions 


The conventions in effect for various terminal devices are shown 
in Table 1-2. 


TABLE 1-2 TERMINAL CONVENTIONS 


OPERATION { CONVENT ION 

Deleting a line Simultaneously depress the CTRL and 
character X keys for all terminals 
except TEC 445 VDU, which uses the 
hash mark (#). Basic communications 
support both # and CTRL XxX _ for line 
deletion for asynchronous remote 
device. 


Depress the BACKSPACE key. For 
terminals without a BACKSPACE key, 
simultaneously depress the CTRL and 
character H keys. 


Ending an input line Depress the carriage return (CR) key. 


Communicating with While an interactive task is executing 
or when a BUILD command is active, 
depress the BREAK key and enter a 
command. 


{ 
H 
H 
H 
\ 
| 
| 
{ 
| 
H 
| Deleting a character 
! 
| 
| 
| 
| 
| 


1.8.2.1 Using the BREAK Key 


If the data request prompt (>) or a BUILD request prompt (B>) is 
displayed and the user wishes to communicate with MTM, depress 
the BREAK key and the system is ready to accept a command. 


If input or output to the terminal is in progress, the BREAK key 
interrupts the process. For example, if the DISPLAY or EXAMINE 
command was entered and the output is in progress, depressing the 
BREAK key halts the output in progress. The system is then ready 
to accept a command. 


If a CSS is currently running, the BREAK key interrupts’ the 
execution of the CSS. The system is then ready to accept a 
command. Once the command has executed, the CSS will resume 
operation unless the entered command affects the status of the 
css. 
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1.8.3 Command Conventions 


Commands are accepted one line at a time. Multiple commands’ can 
appear on the same line, but each must be separated by a 
semicolon. Multiple commands are executed sequentially. If an 
error is encountered in a multiple command line that was entered 
from a terminal, the commands following the command in error are 
ignored by MTM. When a command line is entered from a CSS, all 
the commands are skipped until a $TERMJOB is found. A’ character 
string preceded by an asterisk in column 1 is a comment. 


1.8.4 File Conventions 


A file is a collection of data stored on a direct access’ storage 
device (DASD). MTM provides terminal users with the capability 
of creating and editing files in an interactive manner. Once 
created, files remain on the system until they are deleted by the 
owner. During the life of a file, ownership can change based on 
the needs of an installation or project. File ownership is 
established and maintained by MTM via an account number 
mechanism. 


1.8.4.1 Private Account Numbers 


During the signon procedure, a terminal user must supply a 
private account number in addition to the correct password. 
Whenever a terminal user allocates a file during an MIM session, 
the MTM system automatically associates the file with the 
terminal user's account number. A file associated with the 
terminal user's account number is referred to as a private file. 


The owner of a private file has unrestricted access to that file 
and can update, execute, access or delete it as required. 
Furthermore, no other terminal user, except users with the 
correct privilege (privileged user), can gain access to another 
user's private files. To supply greater flexibility for file 
sharing, however, MIM supports the concept of group files. 


1.8.4.2 Group Account Numbers 


Authorized MTM terminal users are assigned a private account 
number and a group account number within the AUF. Unlike the 
private account number, a terminal user is not required to submit 
the group account number during the signon procedure. In fact, 
a terminal user does not need to know the group account number; 
it will generally be the private account number of a different 
authorized terminal user. By using the RENAME command and 
supplying the letter G in the account field, a terminal user can 
change a private file to a group file. 
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As an illustration of the use of group files within an 
installation, consider a normal development activity consisting 
of two or more members working under a project leader's control. 
During the early development phase, each member would probably 
work alone, using private files. However, during the _ project 
integration phase, the majority of the private files would be 
switched to the project leader's private account number, which 
was defined as the group account for the individual members. 


Once a private file has been switched to a group file, the 
original private owner no longer possesses unrestricted file 
manipulation capability. Instead, the file can be read or 
executed by the original owner and any other terminal user with 
the same group number. Updating or deleting the file can now be 
performed by any terminal user who signs on with the group 
account number. 


Although the use of group files provides a somewhat flexible file 
sharing capability, it does not address the problem of universal 
sharing. For this purpose, MTM supports the concept of system 
files. 


1.8.4.3 System Account Numbers 


Similar to switching a private file to a group file, a terminal 
user can supply the letter S in the file account field 
instead of the letter G. The letter S indicates that this 
private file is now considered a system file. System files have 
an account number of 0. They can be read or loaded by any 
authorized MTM terminal user, but updating or deleting a system 
file can only be performed by the system operator. ; 


With respect to file ownership within an MTM environment, the 
system operator is viewed as more privileged than terminal users. 
The system operator can allocate files on any account in the 
system and can also change the account number of any file in the 
system to another account number. Similar to a terminal user, 
the system operator uses the RENAME command to change file 
ownership. 

1.8.4.4 File Descriptors (fds) 

Some commands require fds. An fd for MTM generally includes four 
fields: 

@ Disk volume name or device name 

@e Filename 


e File extension 


@e File class 
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Format: 


Parameters: 


voln: 


filename 


-ext 
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filename [- [ext] ] /)c 
Ss 


n 


is the name of the disk volume on which the 
file resides or the name of a device. voln 
can be from one to four characters; the first 
character must be alphabetic, the remaining 
alphanumeric. This parameter need not be 
specified. If this parameter is not 
specified, the default user volume is used. 
When voln is not specified, the colon 
separating voln and filename must not be 
entered. Where voln refers to a device name, 
a colon must follow the device name, and 
neither the filename nor the extension is 
entered. 


is the name of a file. A filename consists of 
one to eight alphanumeric characters, the 
first of which must be alphabetic. 


is a l- to 3-character alphanumeric string 
preceded by a period (.) specifying the 
extension to a filename. If the period and 
extension are omitted, a default extension is 
appended to the filename, if appropriate for 
that particular command; otherwise, it remains 
blank. If the - period is specified and the 
extension is omitted, the default is blanks. 


indicates a private file. A private file has 
the same account number as the terminal user's 
current private account number. All of the 
facilities for file manipulation are available 
to the owner of this file. No other user has 
access to this file unless the user has 
certain standard file access privileges 
(privileged user) or the file is also a group 
file. That is, the user's’ private account 
number is the same as some other user's group 
account number. P is the default value if 
neither P, G nor S is indicated in the 
command. 


Examples: 


PACK: FRED. TSK 


FRED.TSK 


ABC: FOO/G 


CARD: 


A:B.C/G 


TEXT.FIL/87 


indicates a group file. A group file, which 
can also be some other user's private file, is 
accessible to members of that group for 
read-only purposes. The group file account 
number in the AUF indicates to the system 
which users can access this group file. 


indicates a system file. A system file has 
account number 0. A terminal user can only 
read a system file. 


is for users that have the privilege to 
specify account numbers’ instead of account 
class designators (P, G and S) and can do_ so 
for some commands such as ASSIGN, LOAD, RENAME 
and CSS calls. Access is limited to shared 
read-only (SRO) if n is not the user's private 
account. 


is a private file FRED.TSK on volume PACK. 

is the same file as in the previous example if 
PACK is the default user volume (private 
file). 


is a group file with filename FOO and a 
default extension on volume ABC. 


is a device name. 


is a group with filename B_ and extension 
C on volume A. 


is a file on the default user volume in 
account 87. 
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2.1 


The 


1. 


CHAPTER 2 
MULTI-TERMINAL MONITOR (MTM) USER COMMANDS 


INTRODUCTION 
following steps comprise a basic MTM terminal session. 


Identify yourself to MTM by signing on to the system. Enter 
your userid, account number and a valid password. 


SIGNON MAR,118,SWDOC 


Establish the volume you will be working on by entering the 
VOLUME command and a valid volume name. 


V M300 


Load the editor task into memory by entering LOAD and the 
task name. 


LOAD EDIT32 
Initiate execution of the task by entering the START command. 


Save all data appended to your file by entering the SAVE 
command. 


S FILEL 


Terminate execution of the task by entering the END command. 


End the terminal session by signing off. 


SIGNOF 
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2.2 ALLOCATE COMMAND 


The 


ALLOCATE 


communications 
manager. 


Format: 


ALLOCATE fd, 


Parameters: 


fa 


CONT IGUOUS 


fsize 


command creates a direct access’ file or a 
line control block (LCB) for a buffered terminal 


keys 
ONE SUS re Saze DON et ie : 
000: 


aa | 
000 


sais We [bsize]] [/[isize]] . 


is the file descriptor of the device or file 
to be allocated. 


specifies that the file type to be allocated 
is contiguous. 


is a decimal number indicating the file size 
required for contiguous files. It specifies 
the total allocation size in 256-byte sectors. 
This size can be any value up to the number of 
contiguous free sectors existing on the 
specified volume at the time the command is 
entered. 
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keys 


EC 


bsize 


isize 


INDEX 


lrecl 


NB 
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specify the write and read protection keys for 
the file. These keys are in the form of a 
hexadecimal halfword; the left byte signifies 
the write key and the right byte signifies the 
read key. If this parameter is omitted, both 
keys default to zero. 


specifies that the file type to be allocated 
is extendable contiguous. 


is a decimal number specifying the number of 
256-byte sectors contained in a physical block 
to be used for buffering. If this parameter 
exceeds the maximum block size established for 
the system, the system maximum is used. If 
bsize is omitted, the default blocksize 
established at system generation (sysgen) or 
by the system operator is used. If no default 
value was established at sysgen or by the 
system operator, the default value is one 
sector for indexed files and 64 sectors for EC 
and nonbuffered (NB) indexed files. When the 
file type is ITAM, bsize is the buffer size in 
bytes. 


is a decimal number specifying the indexed 
block size. If isize is omitted, the default 
indexed blocksize established at sysgen or by 
the system operator is used. If no default 
value was established at sysgen, the default 
value is one sector for indexed files and 


three sectors for EC and NB files. Like 
bsize, isize cannot exceed the maximum block 
size established at sysgen. If the value 


specified for this parameter is greater than 
the system maximum, the system maximum is 
used. 


specifies that the file type to be allocated 
is indexed. 


is a decimal number specifying the logical 
record length of an indexed file, NB indexed 
file or ITAM device. lrecl cannot exceed 
65,535 bytes. The default value for lrecl is 
126 bytes. It may optionally be followed by 
a slash (/), which delimits lrecl from bsize. 
For NB files, this number must be even. 


specifies that the file type to be allocated 
is nonbuffered indexed. 


specifies a long record file. For LR files, 
the logical record length is specified by the 
data block size (bsize) parameter (i.e., the 
logical record length is the data block size). 


ITAM specifies that the device to be allocated is 
a communications device. 


Functional Details: 


The MTM user can only allocate files in their private account. 
To assign an indexed file, sufficient room must exist in system 
space for two buffers, each of the stated size. Therefore, if 
bsize or isize is very large, the file might not be assignable. 
At sysgen time, maximum block size parameters are established in 
the system and neither isize nor bsize can exceed these 
constants. If the user specifies numbers greater than the system 
maximum for bsize or isize, the maximum is_ used. No error 
message will be displayed in such cases. 


The system maximums for bsize and isize can easily be determined 
by specifying numbers for them that are obviously too large. 
When the file is subsequently displayed (DISPLAY FILES command), 
the system maximums are shown rather than the specified numbers. 


To assiqn an EC or NB file, sufficient room must exist in system 
space to contain only the index block of the stated size. The 
data blocks for EC and NB files are not buffered in system space 
and thus are not constrained to the sysgened block size. 


For LR files, the absolute maximum data block size (logical 
record length) that can be specified is 65,535 (64K) sectors. 
This equals an absolute maximum logical record length of 
16,776,960 (16M) bytes. In practice however, the actual maximum 
logical record length for any given system is limited by the 
amount of memory available for input/output (1/0) buffering. 


The ALLOCATE command can be entered in command mode, task-loaded 
mode, task-executing mode and command substitution system (CSS) 
mode. 


Examples: 


Allocate on the default user volume a contiguous file named 
JANE.TSK whose total length is 64 sectors (16kb) with protection 
keys of 0: 


AL JANE.TSK,CO,64 


Allocate on volume M300 an indexed file named AJM.BLK with a 
logical record length of 132 bytes, a data block size of four 
sectors and the default isize established for the _ system. The 
protection keys default to 0. When this file is assigned, the 
system must have 2.25kb of system space available for buffers. 


AL M300:AJM.BLK, IN, 132/4 
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Allocate on the default user volume an indexed file named 
THISFILE (blank extension) with a logical record length of 256 
bytes, a data block size of four sectors, an index block size of 
two sectors and protection keys of 0. 


AL THISFILE,IN,256/4/2 


Allocate on volume VOL1 an indexed file mamed AJM.OBJ whose 
logical record length is 126 bytes. The buffer size and indexed 
block size default to the values established for the system and 
the protection keys default to 0.) 


AL VOL1:AJM.OBJ, IN, 126 


Allocate on volume VOl an indexed file named AJM.OBJ with logical 
record length of 126 bytes. The data block size defaults to the 
value established for the system, the index block size is three 
sectors and the protection keys default to 0. 


AL VO1:AJM.OBJ,IN,126//3 


Allocate on volume SYS an extendable contiguous file named 
XFILE.DTA with a default data block size of 64 sectors and an 
index block size of three sectors. The file initially contains 
no records and has a record length of one sector (same as a 
contiguous file). 


AL SYS: XFILE.DTA,EC 


Allocate on the default volume a nonbuffered indexed file named 
YFILE.DAT with a logical record length of 240 bytes, a data block 
size of 250 sectors and an index block size of five sectors. The 
file initially contains no records. 


AL YFILE.DAT,NB,240/250/5 
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2.3 ASSIGN COMMAND 


The ASSIGN command assigns a device, file or communications 
device to one of a task's logical units. 


Format: 


access privileges SVC15 
SVCF 
keys VFC 
ASSIGN lu,fd|, ry ae ,| HI 
O000: LOW 
MEDIUM 
Parameters: 
lu is a decimal number specifying the logical 
unit to which a device or file is to be 
assigned. 
fd . is the file descriptor of the device or file 
to be assigned. 
access are the desired access privileges. The 


privileges default access privileges are: 


e SRW for contiguous files. 


@ SREW for indexed, nonbufferedq indexed and 
extendable contiguous files. 


@ SRO for any files that are not the user's 
private files. 


@e ERW for devices (except the user's console. 
This has SRW). 


keys signify the read/write protection keys of the 
file or device to be assigned. 

SVvC15 signifies that the specified device is to be 

SVCF assigned for supervisor call 15 (SVC15) 


access. SVCF is the hexadecimal equivalent of 
SVC15 and can also be specified. This option 
pertains to communications devices only. 
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If SVC15 access is specified, neither vertical 
forms control (VFC) nor tape density can be 
specified. 


VFC specifies the use of vertical forms control 
for the assigned lu. If this parameter is 
specified, SVC15 access or tape density 
selection cannot be specified. If this 
parameter is omitted, there is no VFC for’ the 
device assigned to the specified lu (unless 
the task was linked with the VFC option). 


HI indicates that the assigned magnetic tape will 
operate at the group coded recording (GCR) 
density rate of 6250 bits per inch (bpi). 


LOW indicates that the assigned magnetic tape will 
operate at the nonreturn to zero inverse 
(NRZI) density rate of 800 bpi. 


MED I UM indicates that the assigned magnetic tape will 
operate at the phase-encoded (PE) density rate 
of 1600 bpi. 


Functional Details: 

If the access privileges and keys parameters are omitted and VFC, 
SVC15, HI, LOW or MEDIUM is’ specified, the positional commas 
belonging to the omitted parameters can be omitted. 

If the access privileges and VFC, SVC15, HI, LOW or MEDIUM 
parameters are specified and the keys parameter is omitted, the 


positional comma belonging to the keys parameter can be omitted. 


Access privileges can be one of the following: 


SRO Shared read-only 

ERO Exclusive read-only 

SwO Shared write-only 

EWO Exclusive write-only 

SRW Shared read/write 

SREW Shared read, exclusive write 
ERSW Exclusive read, shared write 
ERW Exclusive read/write 


If the file is not in the user's private account, only the _ SRO 
access privilege is valid. 


When the SVC15 option is specified, only SRW, SREW, ERSW and ERW 
access privileges are accepted. 


The DISPLAY LU command can be used to determine the current 
access privileges of all assigned units. 
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The ASSIGN command is rejected if the requested access privilege 
cannot be granted. 


When a task assigns a file, it might want to prevent other tasks 
from accessing that file while it is being used. for this 
reason, the user can ask for exclusive access privileges, for 
either read or write, at assignment time. This is called dynamic 
protection because it is only in effect while the file remains 
assigned. 


A file cannot be assigned with a requested access privilege if it 
is incompatible with some other existing assignment to that file. 
A request to open a file for EWO is compatible with an existing 
assignment for SRO or ERO, but is incompatible with any existing 
assignment for other access privileges. Table 2-1 illustrates 
compatibilities and incompatibilities between access privileges. 


TABLE 2-1 ACCESS PRIVILEGE COMPATIBILITY 


— me Ree a ee oe ee Gee eet ee Ge A ee oo oe ee cums Ge ee eee ok eee eee ee eee eee ee ee ee ee ee re ee ee ee ce es ee ee ee rey Oe Owe ee Ge BS ee eee ee ee oe 


| ERSW | ERO {| SRO } SRW | SWO | EWO | SREW {| ERW | 


ERSW j = * 


- — _ — _ —_ 


* x 


ERO 


* x 


SRO 
SRW 
SWO 


EWO 


as a as, aaa cate fae eb ses, ten as ew Tae ore 
wi Sine ee Se ee es Se ealee oe Se Se 
ile aie wel eee ee Cle eee ee 
Seino ee Stee eo ed ee Saree SS Se Sl ee 
me we ee ee ee ee ee ee ee re ee es ee oe we 
iin Rt emia Fas a ina Sats ea seria eevee eee aoe! 
ie ts ae ea aie eo te oe Sele eee ee Salam 
Soe Se anew eee oo oe ee 
a Se ac ra a Se erie ile ee 


An asterisk (*) indicates compatible. 
A hyphen (-) indicates incompatible. 


The keys format is a 4-digit hexadecimal number. The left two 
digits signify the write protection key and the right two digits 
signify the read protection key. If omitted, the default is 
oooo. These keys are checked against the appropriate existing 
keys for the file or device. If the keys are invalid, the 
command is rejected. The keys associated with a file are 
specified at file allocation time. They may be changed by a 
REPROTECT command or through an SVC7 reprotect function call. 
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If the value of the keys is within the range X'O1' to X'FE', the 
file or device cannot be assigned for read or write access unless 
the requesting task supplies the matching keys. If a key has a 
value of X'00O', the file or device is unprotected for that access 
mode. Any key supplied is accepted as valid. If a key has a 
value of X'FF', the file is unconditionally protected for that 
access mode. It cannot be assigned to any user task (u-task) for 
that access mode, regardless of the key supplied. 


Examples: 


WRITE READ 


KEY KEY MEAN ING 

00 00 Completely unprotected 

FF FF Unconditionally protected 

07 00 Unprotected for read; conditionally protected 
for write (user must supply write key = X'07') 

FF A7 Unconditionally protected for write; 
conditionally protected for read 

00 FF Unprotected for wr ite; unconditionally 
protected for read 

27 32 Conditionally protected for both read and 
write 


An assigned direct access file is positioned at the end of the 
file for access privileges SWO and EWO. It is positioned at the 
beginning of the file for all other access’ privileges. If the 
specified lu is already assigned, the command is rejected. To 
reassign an lu for an active task, the'lu must first be closed. 


If the HI, LOW or MEDIUM parameter is not chosen when assigning 
to a mag tape device, the standard default density is used. The 
default is dependent upon the type of tape drive in use. 


NOTE 
If this parameter is used to select the 
density of the assigned mag tape, SVC15 
or VFC access cannot be specified. The 


HI, LOW and MEDIUM parameter options are 
positionally independent. 


The ASSIGN command can be entered in task-loaded mode. 
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Examples: 
The following assigns a disk file to lu2. The EWO access 
privilege causes the file to be positioned at the end. It is 


conditionally protected with write and read keys of 99AA. New 
records are appended. 


AS 2,FILE.DAT,EWO,99AA 


The following assigns a disk file to lu2. VFC is in use. Access 
privileges and keys parameters are omitted along with their 
respective comnas. 


AS 2,TEST.JOB,VFC 


The following assigns a disk file to lu2. VFC is in use. Access 
privileges and keys parameters are omitted, but positional commas 
are specified. 


AS 2,TEST.JOB,,,VFC 


The. following assigns a disk file to lu2. VFC is in effect. The 
Keys parameter, along with the positional comma, is omitted. The 
privilege is SRO. 


AS 2,TEST.JOB,SRO,VFC 


The following assigns a mag tape drive to lu2. The LOW parameter 
indicates that the drive will operate at the NRZI density rate of 
800 bpi. 


AS 2,MAG1:,LOW 


The following assigns a mag tape drive to 1lu2. The MEDIUM 
parameter indicates that the drive will operate at the 
phase-encoded density rate of 1600 bpi. 


AS 2,MAG1:,SRW,MEDIUM 
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The following assigns a mag tape drive to lu2. The HI parameter 
indicates that the drive will operate at the GCR density rate of 
6250 bpi. Access privileges and Reve parameters are omitted, but 
positional commas are specified. 


AS 2,MAG1:,,,HI 
Invalid Examples: 
The following is an invalid assignment because the positional 


comma belonging to the omitted access privileges parameter must 
be specified. 


AS 2,TEST.JOB, OOFF,VFC 


The following is an invalid assignment because VFC and SsvVC15 
access are mutually exclusive and cannot be specified in the same 
assignment. 


AS 2,TEST.JOB,SRO,VFC,SVC15 


The following is an invalid assignment because tape density and 
SVCF access are mutually exclusive and cannot be specified in the 
same ASSIGN command. 


AS 2,MAG1:,SRW,LOW,SVCF 
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2.4 BFILE COMMAND 

The BFILE command backspaces to the preceding filemark on 
magnetic tapes, cassettes and direct access files. 

Format: 


BFILE [fa,] lu 


Parameters: 


fd is the file descriptor of the device or file 
to be backspaced to a filemark. 

lu is the logical unit to which the file is 
assigned. If lu is specified without fd, the 


operation is performed on the lu regardless of 
what is assigned to it. 


Functional Detail: 


The BFILE command can be entered in task-loaded mode. 


Examples: 
The following example causes the device or file assigned to lul 
to backspace one filemark. 


BF 1 


The following example causes file AJM.OBJ, which is assigned to 
lu4 on volume M300, to backspace one filemark. 


BF M300:AJM.OBJ,4 
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2.5 BIAS COMMAND 


The BIAS command sets a base address for the EXAMINE and MODIFY 


commands. 
Format: 


address 
BIAS 


x 


Parameters: 


address 


Functional Details: 


is a hexadecimal bias to be added to the 
address given in any subsequent EXAMINE or 
MODIFY command. For a u-task, the address 
must be a valid address that exists for the 
u-task. For an executive task (e-task), the 
address can be any valid address in the 
system. The addresses must be aligned on a 
halfword boundary. If address is omitted, it 
is assumed to be the beginning of the task. 


sets bias to 0 for a u-task and to the 
physical load address for an e-task. 


A BIAS command overrides all previous BIAS commands. The user 
should enter a BIAS command if the current value is unknown. 


The BIAS command can be entered in task-loaded and task-executing 


modes. 


Example: 


The following example sets the bias to 100. 


BI 100 
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2.6 BREAK COMMAND 


The BREAK command returns a break status (X'8200') to a task with 
an outstanding I/O on the MTM terminal. 


Format: 
BREAK 


Functional Detail: 


The BREAK command can be entered in task-executing mode. 
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2.7 BRECORD COMMAND 

The BRECORD command backspaces to the preceding record on 
magnetic tapes, cassettes and direct access files. 

Format: 


BRECORD [fd,] 1u 


Parameters: 


fd is the file descriptor of the device or file 
to be backspaced one record. 

lu is the logical unit to which the file is 
assigned. If lu is specified without fd, the 


operation is performed on the lu regardless of 
what is assigned to it. 


Functional Detail: 


The BRECORD command can be entered in task-loaded mode. 


Examples: 
The following example causes the device or file assigned to lul 
to backspace one record. 


BR 1 


The following examplé causes the file AJM.OBJ assigned to 1lu4 on 
volume M300 to backspace one record. 


BR M300:AJM.OBJ,4 
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2.8 BUILD AND ENDB COMMANDS 


The BUILD and ENDB commands copy data from the command _ § input 
device to the fd specified in the BUILD command. 


Format: 


Parameters: 


ne 


ENDB 


fd 


APPEND 


lu 


lu 


fd [,APPEND 


is the file descriptor of the device or file 
to which data is copied. If fd does not 
contain an extension, .CSS is used as default. 
If a blank extension is desired, the period 
following the filename must be typed. If fda 
refers to a direct access file, an indexed 
file by that name is allocated with a logical 
record length equal to the command buffer 
length established at sysgen, a blocksize of 
l and keys of 0000. If the specified fd 
already exists, that fd is deleted and a new 
fad is allocated. 


allows the user to append data to an existing 
fd. If the fd does not exist, it is 
allocated. 


is the logical unit to which data is to be 
copied. A temporary file is allocated and the 
BUILD data is copied to it. When the ENDB is 
encountered, the temporary file is assigned to 
the specified lu of the loaded task. This 
form of the BUILD command is only valid when 
a task is loaded. 
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Functional Details: 


Lines entered from the terminal after the BUILD command are 
treated as data and are copied to the specified device or file 
until an ENDB command is encountered. ENDB may be followed by 
other commands in the command line. Data following the ENDB 
command is treated as a command. 


If any data follows the BUILD command on the same line, it is 
treated as a comment and no action is taken. 


The BUILD command can be entered from the terminal only if a CSS 
is not active. It can be entered in command, task-loaded and 
task-executing modes. 


Example: 
BUILD ASSN 
AS 1, CR: 
AS 2, OUT.OBJ 
AS 3, PR: 
AS 5, CON: 
ENDB 
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2.9 CANCEL COMMAND 

The CANCEL command terminates a task with an end of task code of 
255. 

Format: 


CANCEL 


Functional Details: 


The normal response to this command is: 
Signon name-END OF TASK CODE=255 PROCESSOR=hh : mm: ss : mmm 


Tne CANCEL command can be entered in task-loaded and task- 
executing modes. 
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a et Gene SEP A eS a a Se SS es ee ee 


so mee me ome ee cee ee ee i ee cms ee ee ee ee eee oe 


2.10 CLOSE COMMAND 


The CLOSE command closes (unassigns) one or more files or devices 
assigned to the currently selected task's logical units. 


Format: 
lu, [pluze.-.,lun| 
CLOSE 
ALL 
Parameters: 
lu is a decimal number specifying the logical 


units to be closed. 
ALL specifies that all logical units of the task 
are to be closed. 
Functional Details: 
Closing an unassigned lu does not produce an error message. A 
CLOSE command can only be entered if the task is dormant or 


paused. 


The CLOSE command can be entered in task-loaded mode. 
Examples: 
The following example closes logical units 1, 3 and 5 of the 
task. 
CL 1,3,5 


The following example closes all logical units of the task. 


CLOSE A 
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2.11 CONTINUE COMMAND 


The CONTINUE command causes a paused task to resume operation. 


Format: 


CONT | NUE [address] 


Parameter: 


address 


Functional Details: 


is a hexadecimal number that specifies where 
the task is to resume operation. If this 
parameter is not specified or is 0, the task 
resumes' at the instruction following the 
pause. 


The CONTINUE command can be entered after the task is paused. 
Executing this command causes the terminal mode to be switched 
from task-loaded to task-executing mode. 
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2.12 DELETE COMMAND 


The DELETE command deletes a direct access file. 
Format: 
DELETE fd, [,f4.,...,fdy] 
Parameter: 
fa identifies the file(s) to be deleted. 


Functional Details: 


The file being deleted must not be currently assigned to an lu of 
any task. A file can be deleted only if its write and read 
protection keys are O (X'O0000'). If the keys are nonzero, they 
can be changed using the REPROTECT command. Only private files 
can be deleted. 


The DELETE command can be entered in command, task- loaded and 
task-executing modes. 
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2.13 DISPLAY COMMAND 


The DISPLAY command is used to display new global or new internal 
variables currently defined by the user. This command will not 
display local variables or global variables. 


Format: 
DISPLAY 

Parameters: 
GVARIABLE 


- IVARTARBLE 


n, /Ng 


fda 


Functional Details: 


es 


JVARIABLE 


indicates that the variables to be displayed 
are new global variables. 


indicates that the variables to be displayed 
are new internal variables. 


specifies that all variables (of the type 
selected via the preceding parameter) between 
the range n, to nz be displayed, where n is a 
decimal number between 1 and the maximum value 
allowed at MIM sysgen for the variable type 
selected. 


is the decimal number of a specific variable. 
nm must be between 1 and the maximum value 
allowed at MTM sysgen for the variable type 
selected. 


specifies that all new global or new internal 
variables be displayed. This is the default 
if no specific variable numbers are entered. 


is the file descriptor of a file or device to 
which the display is to be output. The 
default for this parameter is the user's 
console. 


The DISPLAY command can be used in command, task-loaded and 
task-executing modes. 
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The current value of each variable is shown in the DISPLAY 
command display. 


Examples: 
The following example illustrates a way to display all new global 


variables currently defined by the user. 


*DISPLAY GVARIABLE 


GVH NBME 65.03 VALUE ob iced ee 8S OS SS wees wed Se OR Se aS Be OSS 
GOl SOURCE TEST.FTN/P 

G03 ILISTDEV SCRT:TEST.LST/P 

G04 BATCH OPTIM XREF 


The following example illustrates away to display information 
about new global variable 3. 


*DISPLAY GVARIABLE, 3 
GV¥ NAME oa oe VADUE GS y's eS ee ee eae oSrs a aoe i ie ee a aes ae 


G03 LISTDEV SCRT:TEST.LST/P 


The following example illustrates a way to display all new global 
variables between 2 and 5. . 


*DISPLAY GVARIABLE, 2/5 


GV¥ NAMES 5 5c VALUES i sa) eta a cre 028 ee ews eye Ss aha aes OO SS AS Se Sty 
G03 LISTDEV SCRT:TEST.LST/P 


G04 BATCH OPTIM XREF 
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l DISPLAY | 
| ACCOUNTING 


2.14 DISPLAY ACCOUNTING COMMAND 


The DISPLAY ACCOUNTING command displays accounting data collected 
for a currently running or previously run task. 


Format: 


Parameter: 


fa is the file descriptor to which the accounting 
information is displayed. The user console is 
the default. 


Functional Details: 


The general format. of the system response to the DISPLAY 
ACCOUNTING command depends upon the configuration of the system. 


In a uniprocessor configuration, the system response is: 


USER CPU TIME hh:mm:ss:ms ppp. p% 
Svc CPU TIME hh:mm:ss.ms ppp. p% 
ROLL CPU TIME hh:mm:ss .ms ppp. p% 
PROCESSOR TIME hh:mm:ss:ms 100.0% ppp.p% 


WAIT ‘TIME hh:mm:ss .ms ppp.p% 
ROLL TIME hh:mm:ss.ms ppp.p% 
ELAPSED TIME hh:mm:ss.ms 100.0% 
ROLLS n 
I/O n 
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For a Model 3200MPS System (multiprocessor configuration), the 
system response is: 


USER CPU TIME hh:mm:ss :ms ppp. p% 
USER APU TIME hh:mm:ss.ms ppp.p% 
SVC CPU TIME hh:mm:ss .ms ppp. p% 
ROLL CPU TIME hh:mm:ss.ms ppp .p% 
PROCESSOR TIME hh:mm:ss.ms 100.0% 


ppp-.p% 
WAIT TIME hh:mm:ss .ms ppp. p% 
ROLL TIME hh:mn:ss.ms ppp. p% 
ELAPSED TIME hh:mm:ss 100.0% 
ROLLS n 
I/O n 


The indicated percentages for USER CPU and USER APU, SVC CPU and 
ROLL CPU time are calculated as percentages of PROCESSOR TIME. 
The indicated percentages for PROCESSOR, WAIT and ROLL times’ are 
calculated as percentages of ELAPSED TIME. For I/O and ROLLS, n 
indicates the number of each that has occurred. All information 
displayed in response to the DISPLAY ACCOUNTING command pertains 
to the current, or most recently executed, task. If no task has 
been loaded or executed during the MTM session, this command is 
meaningless and the system responds to it with a SEQ-ERR message. 


The DISPLAY ACCOUNTING command can be entered in command mode 
(providing at least one task has been run during the current 
terminal session), task-loaded mode, task-exccuting mode and CSS 
mode. 


Examples: 


The following is an example for a uniprocessor system: 


*DISPLAY ACCOUNTING 


USER CPU TIME 9:10.344 84.4% 

SVC CPU TIME 1:41.975 15.6% 

ROLL CPU ‘I'l ME 0.000 0.0% 
PROCESSOR TIME 10:52.319 100.0% 85.9% 
WAIT TIME = 1:46.764 14.1% 
ROLIL TIME 0.000 0.0% 
ELAPSED TIME 12.39 100.0% 

ROLLS 0 

I/O 176759 
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The 


following 


*D A 
USER: CPU 
USER APU 
SVC CPU 
ROLL CPU 
PROCESSOR 
WAIT 

ROLL 
ELAPSED 
ROLLS 

I/O 


example is for a Model 3200MPS System: 


TIME 
‘TIME 
TIME 
TIME 
TIME 
TIME 
TIME 
TIME 


16.7% 
26.6% 
56.7% 
~ 0.0% 
100.0% 


8.9% 
91.1% 
0.0% 
100 .0% 
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{ DISPLAY DEVICES | 


2.15 DISPLAY DEVICES COMMAND 
The DISPLAY DEVICES command displays to the specified fd the 


physical address, keys, on-line/off-line state and volume name 
(for on-line direct access devices) of all devices in the system. 


Format: 


DISPLAY DEVICES B 


Parameter: 


fa is the file descriptor specifying the file or 
device to which the display is routed. If fd 
is omitted, the default is the user console. 


Functional Detail: 


The DISPLAY DEVICES command can be entered iin command, task- 
loaded and task-executing modes. 


Example: 
DD 
NAME DN KEYS 
NULL 0 0000 D300 FC 0000 M300 CD 
D301 DC GOd00 M301 CD D67A EC 0000 M67A CD 
D67B ED GO000 MTM SYS cD DO5A cCcé 0000 OFF 
DO58 C7 0000 ‘FIXD CD MAG2 95 0000 
MAG3 C5 0000 MAG4 D5 0000 
CON 2 0000 CR 4 0000 
PRT 63 0000 PR 0 0000 SPOL 
PR1 0 0000 SPOL CT34 34 0000 
CT36 36 0000 CT3C 3C 0000 
CT42 42 0000 CT46 46 0000 
CT4C 4C 0000 CT72 72 0000 
CT74 74 0000 CT7A 7A 0000 
cT7C 7C G0060 IT7E 7E 0000 ITAM 
DI18 18 0000 ITAM BI18 18 0000 
BQLA B88 Q000 ITAM BQ2A B8 0000 I TAM 
BQ3A B8 G000 ITAM BOPA B8 0000 ITAM 


48-043 FOO RO2 2-27 


In the DISPLAY DEVICES output, the screen or page is divided in 
half in order to display more devices per page (or screen). The 
definition of the columns is applicable to either half of the 
display. 


e Columns 1, 2 and 3 contain the device name, device number 
(address) and keys, respectively. 


e Column 4 is only defined for pseudo-print (spool), ITAM 
(communications) and direct access devices. The characters 
SPOL specify that the devices are pseudo-print devices used in 
spooling. For direct access devices, column 4 contains the 
characters OFF to indicate that the device is off-line. If 
on-line, the volume name is output in column 4. 


@ For write-protected disks, column 5 contains the characters 
PROT. For MTM users, if the disk is write-protected, column 
5 contains the characters SYS; if the disk is restricted, 
column 5 contains the characters RES. 


e If the secondary directory option is enabled, the last column 
contains the characters CD. 


Pseudo devices created by the SVC intercept facility are 
displayed as an fd with asterisks (*) filling the filename and 
extension fields. As an example, all SPL/32 spooler pseudo 
devices are displayed in this manner. 
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2.16 DISPLAY DFLOAT COMMAND 


The DISPLAY DFLOAT command displays to the specified fd the 
contents of the double precision floating point (DPFP) registers 


associated with the loaded task. 


Format: 


DISPLAY DFLOAT Fy 


Parameter: 


fd is the file descriptor specifying 
device to which the contents 


the file or 
of the DPFP 


registers associated with a _ user-specified 


task are displayed. If fd is 
default is the user console. 


Functional Details: 
This command suspends the current task, displays the 
the DPFP registers and releases the task. The 


released if it has not already been suspended by the 


The user-specified task should have been built with 
option at Link time. 


omitted, the 


contents of 
task is only 
user. 


the DFLOAT 


The DISPLAY DFLOAT command can be entered in task-loaded and 


task-executing modes. 


Example: 
D DFL 
0,2 00000000 00000000 00000000 00000000 
4,6 00000000 00000000 00000000 00000000 
8,A 00000000 00000000 09000000 00000000 
C,E 00000000 00000000 00000000 00000000 


48-043 FOO RO2 


2.17 DISPLAY FILES COMMAND 


The DISPLAY FILES command permits information from the directory 
of one or 


fd. 


Format: 


more direct access files to be output to a specified 


DISPLAY FILES , voln: [filename | [: Lext] | 


Parameters: 


voln: 


user vol 


oO 42 Q 


I. 


NOTE 


See Functional Details for variations on 
the DISPLAY FILES command syntax. 


specifies that all files with the user account 
number be displayed regardless of the volume 
in which they reside. Entering the colon with 
part of a filename limits the file search to 
filenames with the specified characters. 


is the 1- to 4-character name of a disk 


volume. The first character must be 
alphabetic, the remaining alphanumeric. If 
voln is omitted, the default is the user 
volume. 
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filename is the l- to 8-character name of a file. The 
first character must be alphabetic, the 
remaining alphanumeric. 


ext is the 1- to 3-character extension to a 
filename. 
P indicates that information is requested for a 


private file. 


s indicates that information is requested for a 
system file; the default is private file only. 


G indicates that information is requested for a 
group file; the default is private file only. 


N indicates that information is requested for 
private and group files. 


O indicates that information is requested for 
group and system files. 


L indicates that information is requested for 
private and system files. 


fd is the file descriptor specifying the file or 
device to which the display is output. If fd 
is omitted, the default is the user console. 


Functional Details: 


A hyphen (-) in the command format requests that all files 
starting with the characters preceding the hyphen or following 
the hyphen are displayed and are subject to any restrictions 
specified in the extension, account number and fd fields. For 
example: 


CAL3 2 - displays all files whose first five characters 
are CAL32. 

CAL32.- Gisplays all files named CAL32 with any 
extension. 

—-.MTM displays all files with the the extension MIM. 

CH-.043 displays all files beginning with CH with an 


extension of 043. 
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The character * requests that all files with matching characters 
in the same position(s) as those entered are displayed. For 
example: 


CAL3 2 * * * displays all files between five and eight 
characters in length whose first five 
characters are CAL32. 


CAL* *CAL displays all files, with a filename eight 
characters long, whose first three and last 
three characters are CAL. 


****32 OBI Gisplays all files with a filename containing 
six characters whose fifth and sixth 
characters are 32 and whose extension is OBJ. | 


An asterisk in the account position indicates that all accounts 
are to be searched for amatch. If the user is a privileged 
user, every account on the system is checked. If the user is a 
nonprivileged user, the P, G and S accounts are checked. 


The characters * and - can be combined in the command format, as 
described previously, to further delimit files displayed. For 
example: 


CAL* *1- displays all files whose first three 
characters are CAL, and whose sixth character 

is l. 
REEKS2.0— Gisplays all files, eight characters long, 


whose last two characters are 32 and whose 
extension begins with a 0. 


A colon entered with part of a filename and a dash displays all 
filenames with the user account number starting with the 
specified characters regardless of the volume on which they 
reside. 


DF, : JIM- 


A colon entered with a specified extension displays all files 
under the user account number with the specified extension 
regardless of the volume on which they reside. 


D F,:.JM 
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An example of the display produced by the DISPLAY FILES command 
from a privileged user is: 


D F,M300:-.- 


VOLUME= M300 


FILENAME..... TY DBS/IBS RECL. RECORDS CREATED....... LAST WRITTEN... KEYS 
SYSEDIT .CMD/00205 IN l/l 80 1 11/10/82 22:30 11/10/82 22:30 0000 
TEST -CSS/00205 IN l/l 132 2 11/15/82 11:30 11/15/82 11:30 0000 
CONTIG. f/00205 Co 35 11/15/82 11:35 11/15/82 11:35 0000 
IN . f/00205 IN 10/3 50 QO 11/15/82 11:35 11/15/82 11:35 0000 


An example of the same DISPLAY FILES command from a nonprivileged 
user is: 


DF, M300:-.- 


VOLUME= M300 


FILENAME...... TY DBS/IBS RECL. RECORDS CREATED....... LAST WRITTEN.. KEYS 
SYSEDIT .CMD/P IN l/l 80 1 11/10/82 22:30 11/10/82 22:30 0000 
TEST -CSS/P IN l/l 132 2 11/15/82 11:30 11/15/82 11:30 0000 
CONTIG. /P co 35 11/15/82 11:35 11/15/82 11:35 0000 
IN 2 /P IN 10/3 50 0 11/15/82 11:35 11/15/82 11:35 0000 


For contiguous files, TYPE (TY) is CO and RECORDS is the size of 
the file in (decimal) sectors. 


For indexed files, TYPE is IN, followed by the data and index 
blocking factors. RECL is the logical record length in (decimal) 
bytes, and RECORDS is the number of logical records (in decimal) 
in the file. 


For nonbuffered indexed files, TYPE is NB, RECL is logical record 
length in (decimal) bytes, and RECORDS is the number of logical 
records (in decimal) in the file. 


For extendable contiguous files, TYPE is EC, and RECORDS is the 
length of the file in sectors (i.e., the size of the file). 


Spool and temporary files are named as *SPOOLF ILE* and 
*TEMPFILE*, respectively (unless the user has the privilege to 
see the actual filenames, in which case the names are displayed). 


The DISPLAY FILES command can be entered in command, task-loaded 
and task-executing modes. 
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NOTE 


If a DISPLAY FILES command is entered by 
a privileged user, the account number of 
each file is displayed. Nonprivileged 
MTM users see only the account class (P, 
G or S). 


Examples: 
The following example displays to the user terminal all files 
with the user's account number on the default user volume. 


DF 


The following example displays file CAL32.TSK in the _ private, 
group and system accounts. 


D F,CAL32.TSK/- 


The following example displays all files in the private, group 
and system accounts on the default user volume. 


D F,-/- 


The following example displays to the device MAG] all files with 
the user's account number on the default user volume. 


D F, ,MAG1: 


The following example displays to the user's terminal all files 
with the user's account number on volume M300. 


D F,M300: 


The following example displays to the user's terminal all files 
on volume M300 with first character A and extension TSK in the 
user's account number. 


D F,M300:A-.TSK 
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The following example displays all files on the default’ user 
volume in the user's account number with a blank extension, 
regardless of filename. The display is routed to device PR1L:. 


D F,-.,PRI: 


The following example displays to the user's terminal all files 
that start with CAL, contain the character 1 in the sixth 
position, have any extension and are in the user's) account 
number . 


D F,CAL**1]-.- 


The following example displays to the user's terminal the files 
named TASK that have one or two character extensions starting 
with the character 5. A separate display of these files is done 
for each on-line disk volume whose name starts with the letter M. 


D F,M-: TASK. 5* 


The following example displays to the user's terminal the files 
named TASK with any extension. A separate display of these files 
is done for each on-line disk volume in the system. 


D F,-:TASK.- 


The following example displays to the user's terminal all files 
that start with the four characters EDIT on all volumes and in 
all accounts regardless of the extension. If the user is not 
privileged, only matching files in the private, group and system 
accounts are displayed. 


D F,-:EDIT-/* 


The following example displays to the user's terminal all files 
in the user's’) private and group account on the default user's 
volume. 


D F,-/N 
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2.18 DISPLAY FLOAT COMMAND 
The DISPLAY FLOAT command displays to the specified fd the 


contents of the single precision floating point (SPFP) registers 
associated with the loaded task. 


Format: 


DISPLAY FLOAT | 


Parameter: 


fd is an optional file descriptor specifying the 
file or device to which the display is output. 
If fd is omitted, the display is output to the 
user's terminal. 


Functional Details: 


The user-specified task must be built with the FLOAT option 
specified at Link time. 


This command suspends the current task, displays the contents of 
the SPFP registers and releases the task. The task is only 
released if it has not already been suspended by the user. 


The DISPLAY FLOAT command can be entered in task-loaded mode. 


Example: 
D FL 
0,2 00000000 00000000 
4,6 00000000 00000000 
8,A 00000000 00000000 
C,E 00000000 00000000 
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2.19 DISPLAY LU COMMAND 
The DISPLAY LU command displays to the specified fd all assigned 
logical units of the loaded task. 


Format: 


DISPLAY LU Ei 


Parameter: 


fa is an optional file descriptor specifying the 
file or device to which the assigned logical 
units are to be displayed. If fd is omitted, 
the default is the user console. 


Functional Details: 


The lu number, file or device name, current access’ privileges, 
current record number and percentage through file are displayed. 
The current record number and percentage through file are 
GQisplayed only for files. For nonprivileged users, the file 
class is shown; for privileged users the account number is shown. 


This command suspends the current task, displays the task's lu 
assignments and releases the task. The task is only released if 
it has not already been suspended by the user. 


The DISPLAY LU command can be entered in task-loaded and 
task-executing modes. 


Example: 
DISP LU 

LU FILE/DEVICE RECORD THRU 
1 M301:DEMO.IN/P,SREW 1500 100.0% 
2 M301:SORT.OUT/P,SREW 1246 83.7% 
3 CON: ,SRW 
4 M67C:&2987406.001/P,SREW 14 58.3% 
5 M67C:&2987407.001/P,SREW 2 66.6% 
9 MTM:SRIMRGII.OVY/S,SRO 141 46.7% 
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PARAMETERS | 


2.20 DISPLAY PARAMETERS COMMAND 


The DISPLAY PARAMETERS command displays the parameters of the 
loaded task. 


Format: 


DISPLAY PARAMETERS E 


Parameter: 


fda is an optional file descriptor specifying the 
file or device to which the display is output. 
If fd is omitted, the default is the user 
console. 


Functional Details: 


This command suspends the current task, displays the task's 
parameters and releases the task. The task is released only if 
it has not already been suspended by the user. 


The suspend status (STAT = 100) is masked for tasks internally 
suspended for commands such as DISPLAY FLOAT, DISPLAY REGISTERS, 
etc. 


Table 2-2 lists the field addresses and data displayed when the 
DISPLAY PARAMETERS command is entered. 
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TABLE 2-2 DISPLAY PARAMETERS COMMAND FIELDS 


Sr coe cme cn eee mimes ERS eemes mme euee GM Gees See Stee SD Ge cme cue Meee ee mee fees me SE ee Some mee See see cue meee Seem mes mee men See ee cee eee ey ee ea ee ee ee es Se ee es ee ee ee ee ee ee 


FIELD {| VALUE H MEAN ING 
| TASK | xxxxxxxx | Task name; also user signon name 
| CTSW XXXXXXXX Status portion of current task status word 
i | (TSW) 
| CLOC : xXXXX Current location 
| STAT XXXXX | Task wait status | 
! TOPT ! XXXXXXX | Task options ! 
| USSP ! MxXXXX ! Current used system space ! 
| MUSP | XXXXX | Maximum used system space | 
| MXSP | xxXXXX ! Maximum allowed system space | 
| CTOP | XXXXX ! Task CTOP | 
! UTOP ! xXXXX | Task UTOP | 
| UBOT | XxXXXX | Task UBOT | 
| SLOC ! XXXXX ! Task starting location | 
! NLU | XXX | Number of logical units (decimal) | 
! MPRI ! XXX ! Maximum priority (decimal) | 
! SVOL ! XXKX ! Default volume ID 


The addresses displayed as CTOP, UTOP and UBOT are not physical 
addresses, but are addresses within the task's own program space. 
CLOC may be a program space address or a physical address ina 
system subroutine being executed on behalf of the task. NLU is 
given in decimal. SVOL is the ASCII default volume ID. The 
fields CTOP, UTOP, UBOT and SLOC are described in detail in the 
OS/32 Application Level Programmer Reference Manual. 


TOPT is given in hexadecimal. The definitions of task option 
bits are listed in Table 2-3. 
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TABLE 2-3 TASK OPTION BIT DEFINITIONS 


0800 


0400 


0200 


0100 


0080 


0040 


0020 


0010 


0008 


0004 


0002 


0001 


0000 
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0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


8000 


4000 


2000 


1000 
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— © 


m © 


HO FO +O FO +O FO +O FO YO YO 


~~ O 


Pu 


MEAN ING 


SS SS Se SS SS SS SS SE ee ee 


Dynamic scheduling disabled 
Dynamic scheduling enabled 


Prompt disabled 
Prompt enabled 


T1/O interpreted without VFC 
All 1/0 interpreted with VFC 


No extended SVC] parameter blocks 
used (excludes communications 1/0) 
Extended SVC] parameter blocks 
used 


New TSW for task event service 
No new TSW for task event service 


Task event all registers saved 
Task event partial registers saved 


Task event no register saved 
Task event register saved 


Not in system group 
In system group 


No console 1/0 intercept 
Console I/O intercept enable 


Universal status reports disabled 
Universal status reports enabled 


Allow e-task load 
Prevent e-task load 


Queued 1/0s not purged on error 
Queued I/Os purged on error 


= U-task 
= k- task 


i! tt 


AF PAUSE 
AF CONT 


NOFLOAT 
Single floating point 


NONRES IDENT 
RES IDENT 
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22 


23 


24 


25 


26 
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TABLE 2-3 


TASK OPTION BIT DEFINITIONS (Continued) 


MASK | MEAN ING 
SSS SEBS ass VSS SSS SS SESS SV TSS SS SS SST SVS ST SS SVS TV SSS SS ETBTE BS es H 
0000 0800 |} O = SVC6 control call H 
| 1 = Prevent SVC6 control call 

{ ] 

( ' 

0000 0400 | O = SVC6 communication call H 
| 1 = Prevent SVC6 communication call 

! ! 

i f 

0000 0200 } O = SVCPAUSE 
} 1 = SVCCONT 

t t 

' § 

0000 0100 } O = NODFLOAT 
| 1 = DFLOAT H 

| ! 

| ‘ § 

0000 0080 |; O = NOROLL H 
} 1 = ROLL ! 

' ’ 

U i 

0000 0040 }; O = No overlay H 
| 1 = Use overlay 

{ . ' 

j I 

0000 0020 } O = Accounting disabled H 
| 1 = Accounting enabled H 

t i 

t j 

0000 0010 ; O = Task can issue intercept call 1 
| 1 = Task cannot issue intercept call i 

| 1 

t ' 

0000 0008 | O = No account privileges i 
| 1 = File account privileges | 

i i 

4 ! 

0000 0004 ; O = Bare disk assign not allowed 
| 1 = Bare disk assign allowed i 

! 1 

1 t 

0000 0002 }; O = Not universal H 
| 1 = Universal H 

| ' 

j i] 

0000 0001 |} O = No keychecks 
{ 1 = Do keychecks 


STAT is 
bits are 


given 


in hexadecimal. 


shown in Table 2-4. 
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The definitions of wait status 


TABLE 2-4 WAIT STATUS BIT DEFINITIONS 


MASK 
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BIT 


OE SS TS SS Se SE SS 2 


27° 


| OOO1 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 


0000 


0000 
8000 
4000 
2000 
1000 
0800 
0400 
0200 
0100 
0080 
0040 
0020 


0010 


MEAN ING 

{ Intercept wait 

I/O wait 

(Any) IOB/WAIT 

Console wait (paused) 

Load wait 

Dormant 

Trap wait 

Time of day wait 

Suspended 

Interval wait 

Terminal wait 

Roll pending wait 
Intercept initialization (MTM) 
Intercept termination (MTM) 


System resource connection wait 


Accounting wait 


Zero status 


NOTE 


indicates an active task. 


CTSW is expressed in hexadecimal. For a definition of the status 
see the 0S/32 Application Level Programmer 


portion of the TSW, 


Reference Manual. 


The DISPLAY PARAMETERS command can be entered in task-loaded and 
task-executing modes. 
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Example: 


The following is an example of the output generated in response 


to a DISPLAY PARAMETERS command: 


*DISPLAY PARAMETERS 


TASK 
CTSW 
CLOC 
STAT 
TOPT 
USSP 


MTMUSER 
00001000 
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| DISPLAY 
REGISTERS 


2.21 DISPLAY REGISTERS COMMAND 
The DISPLAY REGISTERS command displays to the specified fd the 


contents of the general purpose user registers associated with a 
loaded task. 


Format: 


DISPLAY REGISTERS | 


Parameter: 


fd is the file descriptor to which the _ contents 
of the general purpose user registers are 
displayed. If fd is omitted, the display is 
output to the user console. 


Functional Details: 


This command suspends the current task, displays the contents) of 
the task's general purpose registers and releases the task. The 
task is released only if it has not already been suspended by the 
user. 


The DISPLAY REGISTERS command can be entered in task-loaded and 
task-executing modes. For u-tasks, the contents of each register 
will be O until the task has started. For diagnostic tasks 
(d-tasks) and e-tasks, register F contains the absolute UBOT 
address until the task has started. 


Example: 


DR 
PSW 000077FO OOO0ES88 

0-3 00000000 00000000 00000000 00004801 
4-7 QOO0E83C 00000000 00000000 OOO00D2EA 
8-B QOOOE8CB 00000000 OOOOE848 00000028 
C-F OQOO0O0E804 OOOOE9DO OOOOE584 OOOOEOS5E 
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2.22 DISPLAY TIME COMMAND 


The DISPLAY TIME command displays the current date and time to a 
specified fd. 


Format: 


DISPLAY TIME ER 


Parameter: 


fda specifies the file or device to which the 
display is to be output. If fd is omitted, 
the default is the user console. 


Functional Details: 


The display has the following format: 
mm/dd/yy hh:mm:ss 

or alternatively (by sysgen option): 
ad /mm/yy hh:mm:ss 


The DISPLAY TIME command can be entered in command, task-loaded 
and task-executing modes. 
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2.23 DISPLAY USERS COMMAND 
The DISPLAY USERS command displays the userid, terminal device 


names and operating mode of all users currently signed on under 
MIM. Additionally, all active batch jobs are displayed. 


Format: 


DISPLAY USERS ; : 


Parameter: 


fda specifies the file or device to which the 
display is output. If fd is omitted, the 
default is the user console. 


Functional Detail: 


This command can be entered in command, task-loaded and task- 
executing modes. 


Example: 
DU 
R-NULL: @$HASPOO BG-CT22 : @MTM—MODE NERD-NULL: @$STAT 
LFS-CT26: )MTM—-MODE JON-CT32 : Q@ECM-MODE VAL-CT2A: >)MTM-MODE 
GRAY -CT2C : @MTM-MODE LYNDA-NULL: @$STAT BJM-CT30 : @MTM-MODE 
DAVE-CT3A: >)MTM-MODE BRI-CT3E: )MTM-MODE JOB3-BATCH>MTM-MODE 
Where: 
> denotes a nonprivileged MIM user. 
Q denotes a privileged MIM user. 
MTM-MODE indicates standard MTM usage. 
ECM-MODE indicates environmental control monitor mode. 
$ indicates foreground task-mode and HASP mode. 
BATCH denotes an active batch job. 
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2.24 ENABLE COMMAND 


The ENABLE command 


allows the prompt or messages’ previously 


suppressed by the PREVENT command to be displayed on the user 


console. 


Format: 
MESSAGE 
PROMPT 
ENABLE< EITM 
TYPEAHEAD 
SVARIABLE 


Parameters: 


MESSAGE 


PROMPT 


ETM 


TYPEAHEAD 


$VARIABLE 


Functional Details: 


The ENABLE command 
system operator. 


allows other MTM users to send messages to the 
user terminal. 


requests the system to print the hyphen prompt 
(-) in task-executing mode. The hyphen is the 
default prompt for task-executing mode. 


displays the end of task message. 

enables input without intervening reads by 
MIM. This allows the user to continually type 
without waiting for a prompt (i.e., no 
connected read request). 


enables variable processing of local and 
global variables on a per user basis. 


does not affect messages originating from the 


Local and global variable support for all MTM users is’ included 
in the MTM sysgen option SGN.VAR. 
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TYPEAHEAD allows for faster typing without losing characters or 
having to wait for the prompt to return. Any characters typed 
during this time are placed on a typeahead character queue and 
then passed to the editor for processing on the following read 
request. This command is only effective on terminals using the 
bidirectional input/output control (BIOC) device driver. 
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2.25 EXAMINE COMMAND 
The EXAMINE command examines the contents of a memory location in 
the loaded task. 


Format: 


mn 


EXAMINE address, /address, Ei 
x 


Parameters: 


address indicates the starting and ending addresses in 
memory whose contents are to be displayed in 
hexadecimal. All addresses specified are 
rounded down to halfword boundaries by the 
system. 

n is a decimal number specifying the number of 


halfwords to be displayed. If n is omitted, 
one halfword is displayed. 


fd is the file descriptor specifying the file or 
device to which the contents of memory are 
displayed. If omitted, the default is the 
user console. 


Functional Details: 


This command suspends the current task, displays the contents of 
the specified location(s) and releases the task. The task is 
released only if it has not already been suspended by the user. 


Specifying only address; causes the contents of memory at that 
location (as modified by any previous BIAS command) to be 
displayed. Specifying address; and address, causes all data from 
the first to the second address to be displayed. 


The EXAMINE command can be entered in task-loaded and task- 
executing modes. 
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Any memory that can be accessed by the loaded task can be 
examined with the EXAMINE command. For example, if a task uses 
a PURE segment that is mapped to segment register F, then 
examining addresses at FO000 or greater will display the contents 
of the PURE segment. 


Examples: 


Examine 24 (decimal) halfwords beginning at relative address 2A0: 


*EXAMINE 2A0,24 

O0002A0 FFFF FFFF 0000 0000 CO8B 44F7 0000 0000 * .......... De tees il 
0002B0 40A5 FAFA 0000 0000 4110 0000 41A0 0000 * @....... A...A... * 
OGO2CO 2E50 4155 5345 0000 CB10 0064 DOB1 0050 * .PAUSE..... a..a2 > 


Examine from relative address 2A0 to relative address 2CF: 


*BIAS 2A0 

*EXA 0/2F 

OOO2ZA0 FFFF FFFF 0000 0000 CO8B 44F7 0000 0000 * .......... Disses * 
0002B0 40A5 FAFA 0000 0000 4110 0000 41A0 0000 * @....... A...A... * 
0002CO 2E50 4155 5345 0000 CB10 0064 D081 0050 * .PAUSE..... G.452 * 
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2.26 FFILE COMMAND 

The FFILE command forward spaces to the next filemark on magnetic 
tapes, cassettes and direct access files. 

Format: 


FFILE [fd,] lu 


Parameters: 


fd is the file descriptor of the device or file 
to be forward spaced one filemark. 

lu is the logical unit to which the file is 
assigned. If lu is specified without fd, the 


operation is performed on the lu regardless of 
what is assigned to it. 


Functional Detail: 


The FFILE command can be entered in task-loaded mode. 

Examples: 

The following example causes the file or device to lul to forward 
space one filemark. 


FF 1 


The following example causes the file AJM.OBJ on volume M300 
assigned to 1u4 to forward space one filemark. 


FF M300:AJM.OBJ,4 


48-043 FOO RO2 2-51 


2.27 FRECORD COMMAND 


The FRECORD command forward spaces one record on magnetic tapes, 
cassettes and direct access files. 


Format: 
FRECORD [fd,]1lu 


Parameters: 
fd is the file descriptor of the device or file 
to be forward spaced one record. 
lu is the logical unit to which the device or 
file is assigned. If lu is specified without 


fd, the operation is performed on the lu 
regardless of what is assigned to it. 


Functional Detail: 
The FRECORD command can be entered in task-loaded mode. 


Examples: 
The following example causes the device or file assigned to lul 
to forward space one record. 


FR 1 


The following example causes file AJM.OBJ on volume M300 assigned 
to 1u4 to forward space one record. 


FR M300:AJM.OBJ,4 
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2.28 HELP COMMAND 


The HELP command displays information on MTM 


development commands. 


Format: 


mnemonic 
HELP 
* 


Parameters: 


mnemonic is 


any valid 


command mnemonic. 


x causes 


deve lopment 


list of all 
to 


commands 


list device. 


Functional Details: 


The HELP command is implemented as 

is entered, 

displayed to 
information 


mnemonic or command 
particular command is 
parameters are omitted, 


command is displayed to the list device. 


Example 
HELP * 
ADD AL (LOCATE ) 
BI(AS) BREA(K) 
CAL CA(NCEL) 
COMMAND COMP I LE 
DE(LETE) D( ISPLAY ) 
ENDB ENV 
FF (ILE) F ILEDESC 
FORTZ FR(ECORD) 
LINK LIST 
MACRO ME (SSAGE ) 
PASCAL PAS (SWORD ) 
PRI (NT) PUN (CH) 
REN ( AME ) REP (ROTECT ) 
RUN RW 
SE(T) SIGNOF (F) 
ST (ART) T (ASK) 
WF ( ILE) XAL (LOCATE) 
INQ(UIRE) PUR(GE) 


For help on any of the above 
<mnemonic>. j 
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AS (SIGN) 
BR(ECORD) 
CL(OSE) 
COMPLINK 
EDIT 

EXA (MINE) 
FORT 
HELP 

L( OAD) 
MO(DIFY) 
P(AUSE) 
REL (EASE) 
REW( IND) 
RVOIL (UME) 
S(IGNON) 
TE (MPF ILE) 
XDE (LETE ) 


command mnemonics, 


MTM or 


the 
on how to 


user 


program 


MTM 


a CSS procedure. 
information on how to use that 
device. If 


list 


BF (ILE) 
BU( ILD) 
COBOL 
CO(NTINUE) 
ENA(BLE) 
EXEC 
FORTO 
INIT 

LOG 
O(PTION) 
PRE (VENT) 


V (OLUME ) 


SUB (MIT) 


type HELP 


and program 


development 


and program 
be displayed to the 


When a 


use the HELP 


Example: 


HELP PASSWORD 


PASSWORD: The PASSWORD command enables any user who has the 
PASSWORD privilege to alter his own signon password. 


FORMAT : 


(PAS)SWORD CURRENT PASSWORD, NEW PASSWORD 


PARAMETERS : 


CURRENT PASSWORD 


must exactly match the user's current account 
password. 


NEW PASSWORD 


specifies the new account password. This password 
replaces the current password in the authorized user 
file. The password can be up to 12 characters’ long; 
remaining characters are truncated. All alphabetic, 
numeric and special characters except blanks, commas 
or semicolons are allowed. 
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2.29 INIT COMMAND 


The INIT command initializes all data on a contiguous file to 
zero. 


Format: 


segsize increment 
I N I T f da ’ Sas 


Parameters: 


fda is the file descriptor of any unassigned, 
unprotected, contiguous file. 

segsize is the size of the buffer space used. The 

increment default is lkb. 


Functional Details: 


INIT is implemented with a CSS procedure that loads and starts 
the File Manager Support Utility as a task. 
The INIT command can be entered in command mode. 


Examples: 


The following example initializes the file DATA.FIL. 


INIT DATA.FIL 


The following example initializes the file DATA2.FIL using a 50kb 
buffer. 


INIT DATA2.FIL,50 
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2.30 LOAD COMMAND 


The LOAD command is used to load a user's task into memory. 


Format: 


LOAD [taskid,;] fd[,segsize increment] [,scTask] 


Parameters: 


taskid specifies the name of the task to be loaded. 

fd specifies the file or device from which the 
task is-being loaded. 

segsize specifies amount of memory in kilobytes (above 

increment the memory size) that the task needs for 
processing. When a task is built (via Link), 
the OPTION WORK=n command adds additional 
memory to atask. The size field in the LOAD 
command overrides’ the amount of memory 
specified by Link. The size is accepted in 
-25kb increments. 

SCTASK specifies that the task is to be loaded as an 
SPL/32 spooler subcontrol task. See the 


SPL/32 Administration and Reference Manual for 


information on 
function. 
spooler being used on the system, use of 


subcontrol tasks and their 
If the SPL/32 spooler is not the 
this 


parameter will generate an error message. 


Functional Details: 


In order to maintain CSS 
used. 


The system will, however, 


compatibility, the taskid (.BG) can be 
ignore it. Any valid taskid can 


be entered, but it will be ignored. 


If a task is loaded from 
searches the user volume 


account. If the file is 
search the SYS volume in 
volume designator was 
2-56 


a direct access device, the system first 
or the specified volume under the user's 
not found in the search, the system will 
the SYS account if an account or a 
not specified in the LOAD command. 
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Only values that the user does not explicitly specify will 
subsequently be searched for. If an extension is not specified 
in the LOAD command, the extension .TSK is assumed. 


The LOAD command can be entered in command mode. 

An error might occur if a user ID under MIM is the same as the ID 
of a task loaded from the system console. If a load or fd error 
is displayed, sign off and sign on again with a different user 
ID. 

A privileged user can specify an account number in the fd. All 
other users can only specify an account class designator (P, G, 
S). 

For a Model 3200MPS System, a user without SVC6 control privilege 
cannot load a task to a nonzero logical processing unit (LPU) 
number. If a nonprivileged user loads a task and then specifies 


the OPTION LPU command with an argument other than zero, the 
following message is displayed: 


*LPU RESET TO O 


Users with SVC6 control privilege can load tasks to LPU numbers 
other than O regardless of the LLE. 


Examples: 


The following example loads the task from file VOL:CAL.TSK. 


LVOL: CAL 


The following example loads the task from the paper tape reader 
punch device. 


L, PTRP: 
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2.31 LOG COMMAND 


The LOG command logs all user input and MTM responses to a 


specified fd. 


Formats: 


. fd 


COPY 


NOCOPY 


Parameters: 


is the file descriptor of the log file or 
device. If no fd is specified, logging is 
terminated. If fd is a file, it must be 
previously allocated. Files are assigned EWO 
privileges so that logged output is added to 
the end of the file. If a log is active when 
another LOG command is entered, the old log is 
closed and the new one is initiated. 


specifies that all output is written to both 
the terminal and the log device. 


specifies that all output (except messages) is 
written to the log device and not to the 
terminal. Messages from other users and the 
operator are written to both the terminal and 
the log device. If this parameter is omitted, 
COPY is the default. 


is a decimal number from 0 to 65,535 
specifying the number of lines after which the 
user log file is to be checkpointed. If this 
parameter is omitted, the default is 15 lines. 
If n is specified as 0, no checkpointing will 
occur. 
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Functional Details: 


The LOG and the SET LOG commands are the same. The command = can 
be entered either way and both command formats perform the same 
function. 


Checkpointing can be done on any type of file. Since indexed 
files are buffered, checkpointing may be useful any time the file 
is being written to. Checkpointing nonbuffered indexed files and 
extendable contiguous files is useful only if the file is being 
expanded. Checkpointing a contiguous file is meaningless; no 
operation is performed. 


The LOG command can be entered in command, task-loaded and 
task-executing modes. 


Example: 


LOG LOG.FIL, COPY, 10 
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2.32 MESSAGE COMMAND 


The MESSAGE command sends a message to a specified user. 


Format: 
userid 
MESSAGE message 
.«QPERATOR 
Parameters: 
userid is the name of the user to whom the message is 


being sent. This ID can be obtained from the 
DISPLAY: USERS command. A userid of .OPERATOR 
sends a message to the system console. 


message is the text of the message that the user wants 
to send. 


Functional Details: 


The user receiving the message receives the userid of the sender 
as well as the message. 


This command can be entered in command, task-loaded and 
task-executing modes. 
Example: 
The following message is sent to userid AVE from userid TK. The 
format of the message sent is: 

ME AVE HELLO MTM USER 


The format of the message received is: 


TK-HELLO MTM USER 
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2.33 MODIFY COMMAND 


The MODIFY command modifies the contents of a memory location in 
the loaded task. 


Format: 
data, 
MODIFY address, [;dataz,...,datan] 
6 
Parameters: 
address is the halfword boundary address at which the 
modification of the contents of memory is to 
begin. 
data is a data field consisting of zero to four 


hexadecimal digits that represents a halfword 
to be written into memory starting at the 
location specified by address. Any string of 
data less than four characters is 
right-justified and left-zero filled. If the 
comma is entered but data is omitted, O is 
entered into one halfword. 


Functional Details: 


This command causes the contents of memory, beginning at the 
halfword location specified by address (modified by any previous 
BIAS command), to be replaced with the specified data. The task 
is suspended, the contents of the specified location are 
modified, and the task is released if it is not already suspended 
by the user. The modify address must be aligned on a _ halfword 
boundary. The number of halfwords that can be modified by a 
single command is limited only by the command buffer size 
established at MTM sysgen. 


The MODIFY command can be entered in task-loaded and 
task-executing mode. 


Any segment (impure, shared or task common) to which a u-task has 


write access can be modified. For an e-task, only the _ impure 
segment can be modified. 
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Examples: 


In the following example each command is used to modify a_ single 
halfword. 


The 
numb 
Limi 


*EXA 2C0,8 
0002CO 2E50 4155 5345 0000 CB10 0064 DOB1 0050 
x 

*MODIFY 2C0,2B43 

*MODI 2C2,4841 

*MOD 2C4,4E47 

*MO 2C6,452B 

x 


*EXA 2C0,8 
Q0002CO 2B43 4841 4E47 452B CB10 0064 DOB1 0050 


* *CHANGE+...d...P * 


command can also be used to modify several halfwords. The 
er of halfwords that can be modified by a single command is 


ted by the size of the command buffer. 


*BIAS 2C0 
*MO 0, 2E50, 4155, 5345,0 
x 


*EXA 2C0,8 


‘0002CO 2E50 4155 5345 0000 CB10 0064 DOB1 0050 


* .PAUSE..... a2. P% 
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2.34 OPTIONS COMMAND 


The OPTIONS command allows an MTM user to change the task options 
of the currently loaded task. 


Format: 


OPTIONS | acti i i tial \ (, NONRESIDENT ] [ [nev fr) ] iP wip] | 


AFCONT INUE 


Parameters: 


AF PAUSE 


AF CONTINUE . 


SVCPAUSE 


SVCCONT INUE 


NONRES IDENT 


LPU=n 


NLPU 
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SVCCONTINUE 


specifies that the task is to pause after any 
arithmetic fault (AF). 


specifies that if the arithmetic fault trap 
enable bit is set, a trap is taken. If the 
bit is not set, the task continues after an AF 
occurs and a message is sent to the log 
device. 


specifies that SVC6 is treated as an illegal 
SVC (applies to background tasks only). If an 
SVC6 is executed within a background task, the 
task is paused. 


specifies that SVC6 is treated as a NO-OP 
(applies to background tasks only). If an 
Svc6 is executed within a background task, the 
task is continued. 


specifies that the task is to be removed from 
memory at end of task. 


sets the task as an LPU-directed task. The 
specific LPU can be specified by n. 


sets the task as a central processing unit 
(CPU)-directed task (invalid if the APUONLY 
option is set by Link). 


—er wer aoe ow 


Functional Details: 


For a Model 3200MPS System with load-leveling executive (LLE) 
enabled, specification of an LPU number other than zero by a user 
without SVC6 control privilege causes the following message to be 
displayed: 


PARM-ERR POS=LPU=n 


The OPTIONS command can be entered in task-loaded mode. 


The LPU and NLPU parameters affect the LPU-directed task status. 
The NLPU parameter resets the LPU-directed task status (i.e., 
task is CPU-directed). If the combination “LPU=n, NLPU" is 
entered, the task's LPU number is set to "n" and the task is 
CPU-directed. This assigned LPU number has no effect until the 
task is changed to LPU-directed. 


Example: 
In the following example, task options are set to allow the task 
to take a trap or log a message depending on the setting of the 


arithmetic fault trap enable bit. If the task is a background 
task, any SVC6 will be treated as a NO-OP. 


OPT AFC,SVCC 
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2.35 PASSWORD COMMAND 


The PASSWORD command enables any MTM_ users 


with the 


PASSWORD 


privilege (privileged user) to alter their own signon passwords. 


Format: 


PASSWORD current password, new password 


Parameters: 


current password must match the user's current account 
password exactly. 
new password specifies the new account password. This 


password replaces the current password in 


the AUF. The password 


can be 


up to 12 


characters long; remaining characters are 


truncated. All alphabetic, 


special characters except blanks, 


semicolons are allowed. 


Functional Detail: 


If a user without the PASSWORD privilege 
command, a MNEM-ERR message is generated. 
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enters the 


numeric and 
commas or 


PASSWORD 


2.36 PAUSE COMMAND 


The PAUSE command pauses the currently running task. 
Format: 
PAUSE 
Functional Details: 
Any I/O proceed ongoing at the time the task is paused is allowed 


to go to completion. This command is rejected if the task is 
dormant or paused at the time PAUSE is entered. 


The PAUSE command can be entered in task-executing mode. 
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2.37 PREVENT COMMAND 
The PREVENT command suppresses either messages or the _ task- 


executing prompt (the hyphen is the default) while an interactive 
task is running. 


Format: 


MESSAGE 
PROMPT 


PREVENT, EIM 


TYPEAHEAD 
SVARIABLE 
' Parameters: 
MESSAGE prevents other MTM users from being able to 


send messages to the user terminal. 


PROMPT suppresses the printing of the task-executing 
prompt (the hyphen is the default) during 
task-executing mode. 


ETM supresses the display of end of task message. 

TYPEAHEAD MTM resumes a normal command read ("*" command 
read). 

$VARIABLE disables variable processing on a per. user 


basis. 


Functional Details: 


If a user did not input any of the parameters, the terminal will 
receive both messages and task-executing prompts. The 
task-executing prompt indicates that either a task or CSS is 
executing. 


If the MTM system includes variable support and the $VARIABLE 
parameter is entered, the overall performance of MTM increases. 
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2.38 PRINT COMMAND 


The PRINT command sends the file to be printed to the spooler for 
subsequent printing. 


Format: 
PRINT fa [,DEVICE=pseudo device] [,COPIES=n] [,DELETE] [, VFC ] 


Parameters: 
fda is the name of the file to be printed. 


DEVICE= pseudo device specifies the print device. If 
this parameter is omitted, output is directed 
to any available print device. 


COPIES= n allows the user to specify the number of 
copies of the file to be output. From 1 to 
255 copies can be made. If this argument is 
omitted, one copy is the default. 


DELETE specifies the file fd is to be deleted after 
the output operation is completed. If this 
argument is omitted and the file is not a 
spool file, the file is retained. 


VFC specifies that vertical forms control is in 
use. Currently, the card punch driver does 
not support VFC. 


Functional Details: 


If the spool option was not selected at 0OS/32 sysgen, this 
command results in an error. 


The PRINT command can be entered in command, task-loaded and 
task-executing modes. 


NOTE 


If the SPL/32 spooler is in use on the 
system, the MTM user has additional 
options available for use with the PRINT 
command. See the SPL/32 Administration 
and Reference Manual for a detailed 
description of these additional options. 
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2.39 PUNCH COMMAND 


The PUNCH command indicates to the spooler that the specified 
file is to be punched. 


Format: 


PUNCH fd [,DEVICE=pseudo device] [,COPIES=n] [,DELETE] [,vFc ] 
Parameters: 


fd is the name of the file to be punched. 


DEVICE= pseudo device specifies the name of the pseudo 
output device. If the DEVICE= parameter is 
omitted, punch output is directed to any 
available punch device. 


COPIES= n is the number of copies desired. From 1 to 
255 copies can be made. If the COPIES= 
parameter is omitted, only one copy is output. 


DELETE specifies that the fd is to be deleted after 
the output operation is performed. If 
omitted, the file is retained. ) 


VFC specifies that vertical forms control is in 
use. Currently, the card punch driver does 
not support VFC. 


Functional Details: 


If the spool option was not selected at 0OS/32 sysgen, this 
command will result in an error. 


The PUNCH command can be entered in command, task-loaded and 
task-executing modes. 


NOTE 


If the SPL/32 spooler is in use on the 
system, the MTM user has additional 
options available for use with the PUNCH 
command. See the SPL/32 Administration 
and Reference Manual for a detailed 
descripion of these additional options. 
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2.40 $RELEASE COMMAND 


The $RELEASE command is used to release a new global or new 


internal variable. 


buffer. This command has no effect on local or global variables 


It also releases the variable's associated 


created with the $SET command. 


Format: 


SRELEASE 


Parameters: 


GVARIABLE 


Functional Details: 


This 


IVARIABLE 


n,/n, 


My. ---Npy 


command 


GVARIABLE 


LVARIABLE 


Vy [--- eM] 


indicates that the variables to be released 
are new global variables. 


indicates that the variables to be released 
are new internal variables. 


specifies that all variables (of the type 
selected via the preceding parameter) between 
the range of nj; /n, be released. n is a 
decimal number between 1 and the value allowed 
at MTM sysgen for the selected variable type. 


n is a decimal number of a variable (either 
new global or new internal) or variables to be 
released. n must be within the range of 1 and 
the maximum value allowed at MTM sysgen for 
the selected variable type. 


specifies that all new internal or new global 
variables be released. This is the default if 
no specific variable numbers are specified. 


can be entered in command, task~-loaded, 


task-executing and CSS modes. 
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In order to reduce buffer overhead, variables that are no’ longer 
being used should be released. If this command is directed to a 
variable that was already released, the command is ignored; no 
error message is generated. 
New internal variables that have a null or zero value are 
automatically released. 
Examples: 
The following example releases all new global variables from 1 
through 5. 

$RELEASE GVARIABLE, 1/5 


The following example releases the new internal variables 
numbered 16, 19, 18 and 25. 


$RELEASE IVARIABLE,16,19,18,25 
The following example releases all new internal variables. 
$RELEASE IVARIABLE, ALL 
NOTE 
This command does not release local and 


global variables created with the $SET 
command . 
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2.41 RENAME COMMAND 

The RENAME command changes the name of an unassigned, direct 
access file. 

Format: 


RENAME oldfd,newfa 


Parameters: 


oldfd is the current file descriptor of the file to 
be renamed. 

newfd is the new file descriptor of the renamed 
file. 


Functional Details: 


The volume ID field of newfd may be omitted. A file can only be 
renamed if its write and read protection keys are 0 (X'0000'). 


The RENAME command can be entered in command, task-loaded and 
task-executing modes. 


The user can only rename private files. 
Example: 
The following example renames file AJM.CUR to AJM.NEW on volume 


VOL. 


REN VOL: AJM.CUR,AJM.NEW 
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2.42 REPROTECT COMMAND 
The REPROTECT command modifies the protection keys of an 
unassigned, direct access file. 
Format: 
REPROTECT fd,new keys 
Parameters: 
fd is the file descriptor of the file to be 
reprotected. 
new keys is a hexadecimal halfword whose left byte 
signifies the new write keys and whose right 
byte signifies the new read keys. 
Functional Details: 


Unconditionally protected files can be conditionally reprotected 
or unprotected. 


The REPROTECT command can be entered in command, task-loaded and 
task-executing modes. 


The user can only REPROTECT private files. 
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2.43 REWIND AND RW COMMANDS 
The REWIND and RW commands rewind magnetic tapes, cassettes and 
direct access files. 


Format: 


REWIND [fd,] lu 
or RW [fd,] lu 


Parameters: 


fd is the file descriptor of the device or file 
to be rewound. 

lu is the logical unit to which the device or 
file is assigned. If lu is specified without 


fd, the operation is performed on the lu 
regardless of what is assigned to it. 


Functional Detail: 


The REWIND and RW commands can be entered in task-loaded mode. 


Examples: 
The following example causes the file or device assigned to lul 
to be rewound. 


REW 1 


The following example causes file AJM.OBJ assigned to 1u4 on 
volume M300 to be rewound. 


REW M300:AJM.OBJ,4 
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2.44 RVOLUME COMMAND 


The RVOLUME command enables an MTM user to allow/disallow access 
to a privately-owned disk. 


Format: 


RVOLUME voln, 


Parameters: 


voln 


ADD 


actno 


RW 


48-043 FOO RO2 


RW 
.,;max actno ) : a] 


ADD, 


actno, [,--- 
REMOVE ie 


ymax actno] 


USERS| ,{actno, - actnos 


ek 


is the volume name of the restricted disk. 


indicates that the specified accounts will 
have access to the restricted disk. 


is a decimal number from O to the maximum 
account number allowed on the system (limit 
65,535) indicating the accounts allowed/ 
disallowed access to the restricted disk. If 
ALL is specified, accounts 0 to the maximum 
account number allowed on the system (limit 
65,635) can access the restricted disk. 


indicates that the specified account has 
read/write access to the restricted disk. If 
this argument is omitted, the default is 
read-only. 


RO indicates that the specified account has 
read-only access to the restricted disk. 


REMOVE indicates that the specified accounts) are 
disallowed access to the restricted disk. If 
ALL is specified, all accounts having access 
to the restricted disk are disallowed access, 
with the exception of the owner's account. 


USERS displays all accounts having access to the 
restricted disk along with the access 
privileges. 


Functional Details: 


A disk marked on as a system disk is treated as a restricted 
Gisk. Account number 255 is the owner. 


The owner of a private disk can allow/disallow other MTM users, 
the system operator and other non-MTM tasks access’ to the 
restricted disk. 


If an owner enters a REMOVE parameter specifying a private 
account, access will be denied to the disk; the owner can still 
add accounts, remove accounts and display accounts that have 
access, along with the respective access privileges. 


For a user with RW access to a restricted disk, accessing 
private, group and system files is exactly the same as accessing 
files on any other disk. 


For a user with RO access to a restricted disk, accessing group 
and system accounts is the same as accessing files on any other 
disk. Files within the user's private account can only be 
assigned SRO or ERO. The user cannot allocate, rename, reprotect 
or delete any files. 


Examples: 


RVOL MTM,U 
00000/RW 00001-00017/R0 00018/RW 00019-00254/R0 
00255/RW 00256-01023/R0 


RVOL MTM,A,87/RW 


RVOL MTM,U 
OO000/RW 00001-00017/R0 00018/RW 00019-00086/RO0 
00087/RW 00088-00254/R0 00255/RW 00256-01023/R0 


RVOL MIM,U,87 
00087/RW 
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RVOL MTM,R, 87 


RVOL MTM,U 
00000/RW 00001-00017/R0 00018/RW 00019-00086/RO 
00088-00254/R0 00255/RW 00256-01023/R0 

RVOL MTM,A,87 

RVOL MTM,U 
00000/RW 00001-00017/R0 00018/RW 00019-00254/RO0 


00255/RW 00256-01023/RW 


RVOL, MTM,U,87-1200 error since account limit was 1023 
ACCT-ERR POS=87-1200 

RVOL, MTM,U,87-1000 

00087-00254/R0 00255/RW 00256-01000/R0 
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2.45 SEND COMMAND 


The SEND command sends a message to the currently selected task. 
Format: 

SEND message [; | 
Parameters: 

message is a l- to 64-character alphanumeric string. 


Functional Details: 


The message is passed to the selected task the same way as an 
SVC6 send message. Following standard SVC6 procedures, the 
message consists of an 8-byte task ID identifying MTM as_ the 
sender, followed by the user-supplied character string. The 
message passed to the selected task begins with the first 
nonblank character following SEND and ends with a CR or semicolon 
(;) as a line terminator. A message cannot be sent to a task 
currently rolled out. 


The receiving task must have intertask message traps enabled in 
its TSW and must have an established message buffer area. See 
the OS/32 Supervisor Call (SVC) Reference Manual for more 
information on SVC6. 
The SEND command can be entered in task-executing mode. 
Example: 

SEND CLOSE LU2,ASSIGN LU3 


The following is received by the task: 


- MT CLOSE LU2, ASSIGN LU3 
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2.46 SET GROUP COMMAND 


The SET GROUP command enables a privileged user to change the 
group account number associated with the account the user is 
currently on. This enables a privileged user to specify any 
account in the system as the current group account. This command 
is only valid when issued by a privileged user. 


Format: 
SET GROUP n 
Parameter: 


n is a decimal number specifying the new group 
account to be associated with the user's 
current account. This number must be within 
the range of O to the maximum account number 
set in AUF (cannot exceed 65,535). 


Functional Details: 
The SET GROUP command can be entered in command, task-loaded, 
task-executing or CSS modes. If a task is loaded or executing, 


MTM also modifies the group account number in the task _ control 
block (TCB). 


If a nonprivileged user enters this command the following message 
is generated: 


MNEM-ERR POS=GROUP 


A user may not set his group account to 255. 
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Example: 


The user signs on to account 205 (with privilege option). The 
group account number associated with account 205 is 240. A 
DISPLAY FILES command of the following format will cause _ the 
files in account 240 (account 205's group account) to be 
displayed: 


DF -.-/G 


A privileged user can then change the group account with the SET 
GROUP command: 


SET GROUP 220 


Now the same DISPLAY FILES command will cause the files in 
account 220 (account 205's new group account) to be displayed. 


The new group account association only exists for the length of 
the current signon session. The group private account 
associations specified with the Authorized User Utility are not 
changed by this command. The privileged user can change group 
numbers as often as desired. 
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| SET KEYOPERATOR } 
2.47 SET KEYOPERATOR COMMAND 
The SET KEYOPERATOR command is used to change the operator 
character used when defining keywords in a CSS call. When 


entered without parameters, this command will display the current 
operator character. 


Format: 


SET KEYOPERATOR [character ] 


Parameters: 

character is any one of the following characters which 
will be used for defining keywords in CSS 

calls: 

> 

% 

& 

# 


If no character is’ entered, the current 
keyword operator is’ displayed. 


Functional Details: 


At signon, the default keyword operator is the equal sign (=). 
When this operator’ is changed via the SET KEYOPERATOR command, 
the new operator remains in effect until signoff or until another 
SET KEYOPERATOR command is entered. 


NOTE 


The SET KEYOPERATOR command only changes 
the operator used when defining keywords 
in a CSS call. It has no effect on the 
operator used when referencing keywords 
within a CSS. 
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If the character designated as the keyword operator is to he 
passed as part of a character string in a CSS call, it must be 


placed within single or double quotes. 
If the keyword operator is used in a CSS call, is not within 


quotes (single or double), and is not a valid keyword assignment, 
the following error message is generated. 


KEYW-ERR POS= 
(x) MUST BE WITHIN ‘OR" IF NOT USED AS A KEYWORD OPERATOR. 


The SET KEYOPERATOR command can be entered in CSS, task-loaded, 
task-executing and command modes. 
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2.48 SET PRIVATE COMMAND 


The SET PRIVATE command enables a privileged user to change the 
private account that the user is currently in without knowing the 
password of the new account. This enables a privileged user to 
access any account on the system as their private account. This 
command is only valid when issued by a privileged user. 


Format: 


SET PRIVATE n 


Parameter: 


n is a decimal number specifying the new private 
account number the user wants to access, 
except account 255. Account 255 can only be 
accessed via SIGNON. n is within the range of 
0 to the maximum account number set in the AUF 
(cannot exceed 65,535). 


Functional Details: 


The privileges of the user's original signon account remain in 
effect regardless of the account the user is currently in. A 
user can neither gain nor lose privileges when moving from 
account to account. 


The SET PRIVATE command can be entered in command, task-loaded, 
task-executing and CSS modes. If a task is loaded or executing 
when a SET PRIVATE command is entered, MTM also modifies the 
private account number in the TCB. 

If a nonprivileged user enters this command, the _ following 
message is generated: 


MNEM-ERR 


48-043 FOO RO2 2-83 


Example: 


The user is signed on to account number 255. A DISPLAY FILES/P 
command displays all files in account 255. The user changes the 
current account with a SET PRIVATE command: 


SET PRIVATE 210 


The current account number becomes 210. The group account number 
remains unchanged. A DISPLAY FILES/P command displays all files 
in account 210. The user can alter private accounts as often as 
desired. Note that account times and usage information used by 
the Accounting Reporting Utility use the original signon account 
number regardless of the account the user is in at signoff time. 
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2.49 SIGNOFF COMMAND 


The SIGNOFF command terminates the terminal session. If a user 
signs off when a task is loaded, the task is cancelled. 


Format: 
SIGNOFF 


Functional Details: 


When a terminal user signs off the system, these messages are 
displayed: 


ELAPSED TIME=hh:mm:s3s PROCESSOR=hh: mm: 88 : mmm TSK-ELAPSED-hh: mn: 8s 
SIGNON LEFT=hh:mn:ss PROCESSOR LEFT=hh:mm: ss 
TIME OFF=mm/dd/yy hh:mm:ss 


The SIGNOFF command can be entered in command, task-loaded and 
task-executing modes. It cannot be followed by another command 
on the same command line. 


SIGNON LEFT and PROCESSOR LEFT messages are not displayed if no 
Limits have been set for the account in the AUF. 
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2.50 SIGNON COMMAND 


The SIGNON command allows a user to communicate with MTM. No 
commands are accepted until a valid SIGNON command is entered. 


Format: 


SIGNON vserid,actno,pasewora| gvrronet- | 


mx L:] 


PROCESSORT I ME 
r =maxt ime 


CPUTIME 


[ ;classid=iocount; [;...,classid-iocountsa] | 


Parameters: 


userid 


2-86 


actno 


password 


ENV I RONMENT= 


is a l- to 8-character alphanumeric string 
specifying the terminal user's identification. 
This parameter must not match any active 
userid or foreground task name. 


is a l- to 5-digit decimal number specifying 
a valid account number (defined in the AUF). 
If the number is greater than the current 
account limit (set in the AUF) or is not an 
established account, an error message is 


‘generated. 


is a l- to 12-character alphanumeric string 
specifying the terminal user's password. 


fd is the file descriptor specifying an 
existing file that will establish the user's 
environment at signon time. 


NULL specifies that the signon CSS routine, 
USERINIT.CSS, should be ignored and the user 
will establish the environment after signing 
on. 
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If the entire keyword parameter is omitted, 
MIM searches all on-line disks for the signon 
css procedure USERINIT.CSS/P. If a 
USERINIT.CSS procedure is not found on the 
private account, the system account on the 
system volume is searched. If USERINIT.CSS is 
found, MTM calls the CSS and executes the 
routine. If it is not found, MT enters 
command mode. 


If the user does not have the ENV= privilege 
(privilege to enter ENV= at signon), MTM will 
ignore this parameter and force USERINIT.CSS 
to be executed (if found). 


PROCESSORTIME= is a decimal number specifying the maximum 

CPUTIME= processor time to which the session is 
limited. Processor time in a Model 3200MPS 
System is CPU+APU time, whereas processor time 
in a uniprocessor system is only CPU time. If 
this parameter is omitted, the default 
established at sysgen is used. If oO is 
specified, no limits are applied. The 
parameter can be specified as: 


mmmm: ss 
hhhh:mmn:ss 
ssss 


classid= is one of the 4-character alphanumeric 
mnemonics specified at sysgen associated with 
each specified device or file class. 


iocount is a decimal number specifying the maximum 
number of I/O transfers associated witha 
particular device class to which the job is 


Limited. If this parameter is omitted, the 
default established at sysgen is used. If O 
is specified, no limits are applied to that 
class. 


Functional Details: 


Tne SIGNON command can be entered in command mode. It cannot be 
followed by another command on the same line. 


When ENVIRONMENT=NULL is specified, the colon is optional. This 
allows the user the ability to specify the null device (NULL:). 


The ENVIRONMENT= parameter may be ignored by the system, 
depending on the user's account privileges. 
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There are several methods used to establish the environment that 
a user will be placed into upon signon. The method that offers 
the most standardization is to establish a system USERINIT.CSS 
file. This file must reside on the system volume on the system 
account. 


Any (or every) account may have a USERINIT.CSS file specific to 
the account. As mentioned, a search for a USERINIT.CSS/P file 
(for the account being signed on to) is conducted prior to the 
search of the system files. By establishing a private 
USERINIT.CSS file, an environment peculiar to the _ specified 
account can be created through the SIGNON command. 


Individual users within an account may wish to be placed into an 
environment other than the standard system or account 
environment. This is accomplished through the creation of a file 
containing the commands necessary to establish the desired 
environment. The user then specifies the fd for this file 
through the ENVIRONMENT parameter. 


Parameters can be entered as specified above or an interactive 
signon procedure can be utilized. By entering only the SIGNON 
command, the user will be prompted to enter each parameter as 
demonstrated in the following example: 


SIGNON 
. )USERID: 

»ACCOUNT: <no-echo> 
>»PASSWORD: <no-echo> 


The purpose of this procedure is mainly for security. When the 
account and password are entered, MTM does a no-echo read which 
is only effective on a terminal configured with the BIOC device 
Griver. A privileged user is additionally prompted with the 
ENVIRONMENT= parameter. Invalid entries to this signon procedure 
will return the following error message: 


-INVALID PARAMETER -- SIGNON REQUIRED 


The user is again prompted for entry with no limit on the number 
of attempts to signon. : 


Examples: 
In the following example, either the account or system 


USERINIT.CSS file can be used to create the signon environment: 


SIGNON ME, 12,PSWRD 
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In the following example, the desired environment is to be 
created after signon: 


SIGNON DAVE, 118,SWDOC,ENV=NULL 


In the following example, the environment is to be created by 
execution of the commands contained in the file specified with 
the ENVIRONMENT= parameter: 


S BETTYSUE,119,DIFRNT, ENV=M301:E0U119.ENV 


The following listing presents an example of a file that might be 
used for environment creation: 


* EOULIS.ENV ~- this file establishes an alternate EASE OF USE 


* (EOU) environment for account 119. It is used in 
* conjunction with the ENVIRONMENT parameter of the 
* the SIGNON command. 


x 


PREVENT PROMPT; $WR 

eRe. GVAR, ALL ;* clear new global variables. 
Define default system devices: 
$DEFINE G10,SSYSLST,ST(P) 
$DEF INE G11, SSYSIN, ST(CON: ) 
$DEFINE G12,SSYSOUT,ST(PR1: ) 
$DEF INE G13,SSYSPRT,ST(CON: ) 
$DEFINE G14,SSYSCOM,ST(CON: ) 
$DEF INE G15,SSYSMSG,ST(CON: ) 
$DEFINE G2,MTMUSR, CUR(USER) 


* list 

* input 

* output 

* print 

* command input 
* message output 
* current userid 


a ke i i, Be Mie 


* 


FORT * get FORTRAN (D compiler) 
* as current environment. 

XALLOCATE @*G2.L0OG,IN,80 * 

* 


LOG @*G2.LOG, COPY 
* 


establish and set a log 
file for the session. 


=—e "eo te tO 


*Display some useful info: 


DISPLAY USERS : show co-users. 


=e 


$WRITE 
DISPLAY TIME ;* show date and time. 
$WRITE 
VOLUME M301; VOLUME 7;* set user volume & display. 
$WR; INQUIRE 7;* any batch jobs? 
$WR 
$WR WELCOME ABOARD - @*G2 7;* say hi. 
ENABLE PROMPT 
$EXIT 
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2.51 SPOOLFILE COMMAND 


This command is valid only on systems that are using the SPL/32 
spooler. Systems on which the OS/32 spooler is being used may 
not use the SPOOLFILE command. 


The SPOOLFILE command allows a user to allocate a spool file on 
behalf of a specified pseudo device and assign that file to the 
specified lu of the currently selected task. This command makes 
all spooling options available at terminal or CSS level. 


Format: 


NOCHECKPOINT 
\ [ PRIORITY=p | 


NODELETE 


[, BLOCK=bsize/isize] 


Parameters: 


lu is a decimal number’ specifying the logical 
unit to which the pseudo device is to be 
assigned. 

lu, indicates that lu is to be assigned to _ the 
same spool file as lu;. lu; must be the first 


lu assigned to the spool file. 
pseudo-dev is the 1- to 4-character name of a pseudo 


device. The first character must be 
alphabetic; the remaining alphanumeric. 
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FORM= 


VFC 
IMAGE 


NO IMAGE 
NOVF C 


CHECKPOINT 


NOCHECKPOINT 


COPIES= 


HOLD 


RELEASE 


DELETE 


NODELETE 


PRIORITY=p 


BLOCK 


bsize 
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is a desired preprinted form name that can be 
specified here. If the form specified was not 
previously enabled using a FORM command, an 
error message is sent to the monitor ing 
control or subcontrol task and the request is 
processed using the default standard form 
name, STD. 


specifies the use of vertical forms control 
for the assigned lu. When VFC is used, the 
first character of each record is’ interpreted 
as a VFC character. If IMAGE is specified, 
there is no VFC for the device assigned to the 
specified lu. 


turns the IMAGE option or VCF option off for 
the assigned lu. NOVFC is the default option. 


turns on checkpointing for the assigned lu. 
This is the default option. The global 
checkpoint option must be on. 


turns off checkpointing for the assigned lu. 


identifies the number of copies to be output. 
It must be between 1 and 255 or an error 
message is sent. 


causes the specified file to remain on the 
spool queue until a RELEASE request is issued. 


enables a spool file for output when the lu is 
closed. , 


the file is deleted after output. This is the 
default option. 


the file is not deleted after output. 


p is the desired print priority. If this 
option is not specified, the print priority 
becomes the same as the priority of the task 
from which the spool file assign originated. 


specifies the index and/or data block size. 


is a decimal number specifying the physical 
block size in 256-byte sectors, to be used for 
buffering and debuffering operations involving 
the file. If this parameter is not specified, 
the default data block size established at 
sysgen or by the system operator is used. If 
this value exceeds the maximum block size 
established for the system, the maximum set at 
sysgen is used. 


ee 


isize is a decimal number specifying the index block 
size in 256-byte sectors. If this parameter 
is not specified, the default index block size 
established at sysgen or by the system 
operator is used. Index size cannot exceed 
the maximum index block size established for 
the system. If a value greater than _ the 
maximum established for the system is 
specified, the maximum is used. 


Functional Details: 


The SPOOLFILE command can be used to make an assignment to a 
pseudo device from the terminal or CSS level. If two conflicting 
parameters are entered in a single SPOOLFILE command, such as 
DELETE and NODELETE, the second parameter is executed and an 
error message is generated. 


The SPOOLFILE command can be entered in task-loaded mode. 


Example: 


The following example causes a spool file to be allocated for 
pseudo device PDl: and assigns that. file to 1lu4 of the current 
task. VFC has been specified for the specified lu and the DELETE 
option has been selected, which means the file will be deleted 
after output. The default physical and index block sizes set at 
sysgen will be used. 


SPOOLFILE 4,PD1:,VFC,DELETE 
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2.52 START COMMAND 


The START command initiates execution of a dormant task. 


Format: 


| an 


Parameters: 


address 


parameter 


Functional Detail: 


ress 


} | Goaraneters ,..,paraneters] 


specifies the address at which task execution 


is to begin. For u-tasks, this is nota 
physical address but an address within the 
task's own program. For e-tasks, it is a 
physical address. If address is omitted or is 
0, the loaded task is started at the transfer 
address specified when the task was 
established. 


specifies optional parameters to be passed to 
the task for its own decoding and processing. 
All user-specified parameters are moved to 
memory beginning at UTOP. If no parameters 
are specified, a carriage return (CR) is 
stored at UTOP. 


The START command can be entered in task-loaded mode. 


Examples: 


The following example starts the currently selected task at 


X'138'. 


ST 138 
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The following example starts the currently selected task at 
X'100' and passes NOSEG,SCRAT to the task. 


ST 100,NOSEG,SCRAT 


The following example starts the currently selected task at 
transfer address and passes 1000,ABC to the task. 


ST ,1000,ABC 
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2.53 TASK COMMAND 


The TASK command maintains CSS 
operating system. No specific 
command. 

Format: 


taskia 
TASK 
«BGROUND 


Parameters: 


taskid 


compatibility of MTM to the 


action is performed by this 


is the name of the taskid that has been loaded 


into the foreground segment of memory. 


- BGROUND 


Examples: 


T .BG 


T COPY 
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indicates that the task has been loaded as a 
background task. 


2.54 TEMPFILE COMMAND 


The TEMPFILE command allocates and assigns a temporary file to an 
lu for the currently selected task. A temporary file exists only 
for the duration of the assignment. When a temporary file is 
closed, it is deleted. 


Format: 


TEMPFILE lu, 


Parameters: 


lu 


CONTIGUOUS 


fsize 


EC 


CONTIGUOUS ,fsize 


[oni] omsea] 2 


> 


is a decimal number specifying the lu number 
to which a temporary file is to be assigned. 


specifies that the file type to be allocated 
is contiguous. 


is a decimal number specifying the total 
allocation size in 256-byte sectors. This 
size can be any value up to the number of 
contiguous free sectors existing on the 
specified volume at the time the command is 
entered. 


specifies that the file type to be allocated 
is extendable contiguous. 
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bsize 


isize 


keys 


INDEX 


lrecl 


NB 


LR 
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is a decimal number specifying the physical 
block size to be used for buffering and 
debuffering operations. bsize represents’ the 
block size in sectors of the physical data 
blocks containing the file. For INDEX files, 
this parameter cannot exceed the maximum block 
size established by sysgen. If a value 
greater than the system maximum is’ specified, 
the system maximum is used. For EC and NB 
files, this parameter may be any value between 
1 and 255 inclusive. If bsize is omitted, the 
default value for INDEX and NB files is the 
value set at sysgen or by the system operator. 
For EC files, the default is 64 sectors. 


is a decimal number specifying the index block 
size. For INDEX and NB files, the default 
value is the value set at sysgen or by the 
system operator. For EC files, the default 
value is three sectors (768 bytes). The index 
block size cannot exceed the maximum disk 
block size established by sysgen. If a value 
greater than the system maximum is specified, 
the system maximum is’ used. isize may not 
exceed 255. 


specify the write and read protection keys for 
the file. These keys are in the form of a 
hexadecimal halfword; the left byte signifies 
the write key and the right byte signifies the 
read key. If this parameter is omitted, both 
keys default to zero. 


specifies that the file type to be allocated 
is indexed. 


is a decimal number specifying logical record 
length in bytes. It cannot’ exceed 65,535 
bytes; its default is 126. The logical record 
length is meaningful only for indexed and 
nonbuffered indexed files. 


specifies that the file type to be allocated 
is nonbuffered indexed. 


specifies a long record file. For long record 
files, the logical record length is specified 
by the data block size (bsize) parameter 
(i.e., the logical record length is the data 
block size). 


Functional Details: 
A temporary file is allocated on the temporary volume. 


To assign this file, sufficient room must exist in system space 
for three buffers, each of the stated size. Therefore, if bsize 
or isize is very large, the file cannot be assigned in some 
situations. A maximum block size parameter is established for 
the system at sysgen or by operator command. If bsize and isize 
exceed this constant, the established maximum is used. 


To assign an EC or NB file, sufficient room must exist in system 
space to contain only the index block of the stated size. The 
data blocks for EC and NB files are not buffered in system space, 
and thus, are not constrained to the sysgened block size. 


The TEMPFILE command can be entered in task-loaded and 
task-executing modes. 


For LR files, the absolute maximum data block size (logical 
record length) that can be specified is 65,535 (64K) sectors. 
This equals an absolute maximum logical record length of 
16,776,960 (16M) bytes. In practice, however, the actual maximum 
logical record length for any given system is limited by the 
amount of memory available for I/O buffering. 


Examples: 


The following example allocates, on the temporary volume, a 
contiguous file with a total length of 64 sectors (16kb) and 
assigns it to lu2 of the loaded task. 


TE 2,CO,64 


The following example allocates, on the temporary volume, an 
index file with a logical record length. The data block and 
index block sizes default to the size established at sysgen or by 
the system operator. The file is assigned to 1ul4 of the loaded 
task. 


TE 14,1N,126 


The following example allocates, on the temporary volume, an 
extendable contiguous file with a default data block size of 64 


and index block size of three sectors. The file initially 

contains no _ records and has a record length of one sector (same 

as a contiguous file). The file is assigned to 1u5 of the task. 
TE 5,EC 
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The following example allocates, on the default temporary volume, 
a temporary nonbuffered indexed file with a logical record length 
of 240 bytes, data block size of 250 sectors and index block size 
of five sectors. The file initially contains no records. The 
file is assigned to lu7 of the task. 


TE 7,NB,240/250/5 
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2.55 VOLUME COMMAND 


The VOLUME command sets or changes the name of the default user 
volume. It may also be used to query the system for the current 
names associated with the user, system, roll, spool or temporary 
volume. 


Format: 
VOLUME [voln] 
Parameter: 


voln is a 4-character volume identifier. If this 
parameter is omitted, all current default 
user, system, roll, spool and temporary volume 
names are displayed. 


Functional Details: 


Any commands that do not explicitly specify a volume name use the 
default user volume. No test is made to ensure that the volume 
is actually on-line at the time the command is entered. If voln 
is not specified, the names of the current default volumes are 
output to the user console. 


The default user volume is initially set to the system volume or 
the default user volume (set at MTM sysgen) when the user signs 
on. If no volume was specified at MTM sysgen, the default is the 
system volume. 

This command can be entered in command, task-executing and 
task-loaded modes. 

Examples: | 

In the following example, the VOLUME command is used to query the 


system. 


VOL 
USR=MT™ SYS=MT™ SPL=M67B TEM=M67C RVL=MTM 
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When MTM is used in conjunction with SPL/32, the spool volume is 
not displayed by the VOLUME command. 


VOL 
USR=MTM SYS=MTM TEM=M301 RVL=MTM 


In the following example, the VOLUME command is used to_ change 
the default user volume and again to query the system. 


V M301;V. 
USR=M301 SYS=MTM TEM=M67C RVL=MTM 
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2.56 WFILE COMMAND 

The WFILE command writes a filemark on magnetic tapes, cassettes 
and direct access files. 

Format: 


WFILE [fd,]1lu 


Parameters: 


fd is the file descriptor of the file or device 
to which a filemark is to be written. 

lu is the lu to which the device or file is 
assigned. If lu is specified without fd, the 


operation is performed on the specified lu 
regardless of what is assigned to it. 


Functional Detail: 


The WFILE command can be entered in task-loaded mode. 

Examples: 

The following example causes a filemark to be written on the 
device or file assigned to lul. 


WF 1 


The following example causes a filemark to be written on file 
AJM.OBJ, which is assigned to 1u4 on volume M300. 


WF M300:AJM.OBJ,4 
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2.57 XALLOCATE COMMAND 


The XALLOCATE command is used to create a direct access file. 


Format: 


Parameters: 


fd 


CONT IGUOUS 


fsize 
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INDEX {| — | [/[psize]] [/[1size]] f e000 


ee 
om [PSII 


keys 
CONTIGUOUS ,fsize},  _ 
0600 


We et 


x26 


— \) steel) [7 Estee) E e000 


is the file descriptor of the file to be 
allocated. 


specifies that the file type to be allocated 
is contiguous. 


is a decimal number indicating file size which 
is required for contiguous files. It 
specifies the total allocation size _ in 
256-byte sectors. This size may be any value 
up to the number of contiguous free sectors 
existing on the specified volume at the time 
the command is entered. 
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keys 


EC 


bsize 


isize 


INDEX 
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specify the write and read protection keys for 
the file. These keys are in the form of a 
hexadecimal halfword; the left byte signifies 
the write key and the right byte signifies the 
read key. If this parameter is omitted, both 
keys default to 0. 


specifies that the file type to be allocated 
is extendable contiguous. 


is a decimal number specifying the physical 
block size to be used for buffering and 
Gebuffering operations on indexed files or 
data communications devices. When INDEX, EC 
or NB is specified, bsize represents the block 
size in sectors of the physical data blocks 
containing the file. When ITAM is specified, 
bsize represents the buffer size in bytes. 
For ITAM buffers, this parameter cannot exceed 
the maximum block size established for the 
system. If avalue larger than the _ system 
maximum is specified, the system maximum is 
used. For EC files, this parameter can be any 
value between 1 and 255 inclusive. 


The default blocksize is established at sysgen 
and can be altered by the system operator. If 
no value is entered for this parameter, the 
Gefault value set at sysgen (or by the system 
operator) is used. If no default was’ set at 
sysgen or by the system operator, the default 
value for INDEX files and ITAM buffers is 256 
bytes (one sector). For EC and NB files, the 
Gefault is 64 sectors. 


is a decimal number specifying the index block 
size. For INDEX and NB files, the default 
value is established at sysgen or by the 


system operator. If no default was 
established through sysgen or by the operator, 
the default value is one sector. For EC 


files, the default value is three sectors (768 
bytes). The index block size cannot exceed 
the maximum disk block size established for 
the system. If a value larger than the system 
maximum is specified, the system maximum is 
used. Neither bsize nor isize can exceed 255. 


specifies that the file type to be allocated 
is indexed. 
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lrecl is a decimal number specifying the logical 
record length of an indexed file or 
communications device. It cannot exceed 
65,535 bytes. Its default is 126 bytes. It 
can optionally be followed by a slash (/), 
which delimits lrecl from bsize. 


NB specifies that the file type to be allocated 
is nonbuffered indexed. 


LR specifies a long record file. LR record 
files, the logical record length is specified 
by the data block size (bsize) parameter 
(i.e., the logical record length is the data 
block size). 


ITAM specifies that the fd to be allocated is an 
ITAM buffered communications device. 


Functional Details: 


The XALLOCATE command is different from the ALLOCATE command in 
that if fd is an existing file, it is deleted and reallocated. 
If fd does not exist, it is allocated. 


If the fd to be allocated is a device name instead of a filename, 
a DEL-ERR TYPE=VOL occurs. 


For LR files, the absolute maximum data block size (logical 
record length) that can be specified is 65,535 (64K) sectors. 
This equals an absolute maximum logical record length of 
16,776,960 (16M) bytes. In practice, however, the maximum 
logical record length for any given system is limited by the 
amount of memory available for I/O buffering. 


The XALLOCATE command can be entered in command, task-loaded and 
task-executing modes. 
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2.58 XDELETE COMMAND 
The XDELETE command is used to delete one or more files. If the 
file does not exist, no error is generated. 
Format: 
XDELETE fd, [-fd,...,fany] — 


Parameter: 


fa is the file descriptor of the file to be 
deleted. 


Functional Details: 

A file can only be deleted if it is not currently assigned to a 
task and its write and read protection keys are 0 (X‘'0000'). 

A nonprivileged MTM user can only delete private files. 


Example: 


XDEL FIXD:0S323240.817,RADPROC.FTN 
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CHAPTER 3 
MULTI-TERMINAL MONITOR (MTM) /NON-MITM 
TASK INTERFACES 


3.1 INTRODUCTION 


MTM allows the terminal user to transfer control of a terminal to 
tasks other than MTM and then return the terminal to MTM control 
in an orderly fashion. This orderly transfer of control is 
accomplished via the use of interface protocols that are invoked 
by specific MTM commands. The MTM terminal user can interface 
with: 


e foreground tasks, 


@ HASP tasks, and 


@ ITC/RELIANCE tasks. 


3.2 INTERFACING WITH A FOREGROUND TASK 


The foreground interface allows an MTM user to connect an MT™ 
terminal to any specified foreground task selected via the 
following command: . 


Format: 
$foreground task-id 
Parameter: 


foreground is a taskid of 1- to 7-characters' specifying 

task-id the selected foreground task to which the MTM 
terminal is to be connected. The following 
taskids are restricted and cannot be used: 


HASP 
- MTM 
- SPL 
ECM 
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Functional Details: 


This feature is available to all MTM users’ that have the 
$foreground privilege. 


This command can be entered in command mode as long as no command 
substitution system (CSS) is active. This command is not 
available in batch mode. While a terminal is connected to a 
foreground task, all MTM messages to that terminal are ignored. 


The foreground task to which this command is directed must have 
particular characteristics and options enabled in order to 
establish, maintain and terminate the interface. The foreground 
task must be linked with option UNIVERSAL and must be able to 
send and receive messages via supevisor call 6 (SVC6). For 
further information regarding SVC6 use, see the 0S/32 Supervisor 
Call (SVC) Reference Manual. : 


Example: 
In the following example, the MTM terminal issuing the $xXYZ 


command becomes connected to the foreground task identified as 
XYZ. 


$XYZ 


A subsequent DISPLAY USERS command from an MTM terminal will 
display the terminal transferred to the foreground task's (XYZ) 
control as shown: 


DAVE - NULL: @$XYZ 


3.2.1 Programming Details 

The foreground task selected with the $FGRND command must have 
the following interface and a message buffer ring with message 
entries enabled. The taskid can have no more than seven 
characters. 


The selected task gets the following message from .MIM: 
ADD terminal-dn,priv-acc,group-acc,userid <CR> 


The foreground task must now assign the terminal with terminal-dn 
and immediately send the following message to .MTM: — 


$STA terminal-dn,status <CR> 
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To return the terminal to MTM control, the foreground task should 
close the terminal and send the following message to .MTM: 


$END terminal-dn<¢CR> 
MTM assigns the terminal and the user returns to MTM control. 
Parameters: 


terminal-dn is the device name of the user's’ terminal 
(variable length from two to five characters 
including a colon (:). 


priv-acc is the user's private account number (fixed 
length of five characters, right-justified, 
leading zeros). 


group-acc is the user's group account number (fixed 
length of five characters, right-justified, 
leading zeros). 


userid is the userid under MIM (fixed length of eight 
characters, left-justified). 


status returned from foreground task: 


X'30' all OK - foreground task has assigned 
the terminal. 


X'3l1' assign-errors - terminal was not 
assigned by the foreground task (.MTM 
reports TASE-ERR to the user). 


X'39' space error - terminal would have 
exceeded the maximum number of allowed 
terminals (.MTM reports TSPC-ERR to the 


user). 
<CR> carriage return (X'OD') 
Functional Detail: 
Every ten seconds, MTM tries to reassign the terminal; i.e., if 


the foreground task closes the terminal or goes to end of task 
without sending a $END message, the user terminal remains 
unassigned no longer than ten seconds. 
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3.3  HASP INTERFACE 


The HASP interface allows an MIM user to communicate with a 
specified HASP control task in the foreground. The option for 
the HASP interface must be enabled at MTM system generation 
(sysgen) in order for it to be available to MTM users. When the 
HASP task is started, the optional start parameter OUT=/MIM must 
be used to allow messages to be output to MTM. To allow command 
input from MTM, the start parameter IN=/MTM must be used. 


Format: 
SHASPxx 
Parameters: 


xx is a 2-character alphanumeric extension of the 
HASP control tasks foreground ID. 


Functional Details: 


Option UNIVERSAL is required when linking the HASP_ task. Once 
the $HASP command has been executed, the MTM terminal is then in 
HASP mode. The HASP mode read prompt is a double quote ("). 


All commands entered on the terminal are sent to the specified 
HASP task. All commands) starting with a dollar sign (§$) are 
prefixed with the HASP message command (i.e., $cmd is expanded to 
MES $cmd; this is transparent to the user) and then sent to. the 
specified HASP task. All messages sent by HASP to the terminal 
are displayed in the following format: 


HASPxx> message..... 


When the user is ready to return the terminal to MTM control, the 
following command is used: 


SMIM 


The terminal is then returned to MTM control. 


The $HASPxx command can be entered in command mode only. No task 
can be loaded or executing, no CSS can be active and the user 
must not be in batch mode. While in HASP mode, MIM messages from 
other users and the system operator can be displayed on the HASP 
terminal. 
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The specified HASP task is set to the same private and group 
account number as the user. If $MTM is entered, the specified 
HASP task remains on these accounts and continues’~ sending 
messages to the user terminal until another user connects to the 
same HASP task or until signoff. 


Example: 


The following example selects the HASP task with the taskid 
HASPO3 in the foreground. The terminal is now in HASP mode if no 
errors occurred. 


$HASPO3 


3.4 INTEGRATED TRANSACTION CONTROLLER (ITC)/RELIANCE INTERFACE 


The environmental control monitor (ECM) provides facilities for 
terminal users to transfer control of their terminals between 
Reliance and MTM, or between different Reliance environments, 
without use of the system console or a Reliance controller's 
terminal. For details about the use of the ECM, see the 
Environmental Control Monitor/32 (ECM/32) Systems Programming and 
Operations Manual. 
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CHAPTER 4 
PROGRAM DEVELOPMENT 


4.1 INTRODUCTION 


This chapter is written as a program development tutorial session 
for new to intermediate users. The program development commands 
enable you to easily create a program and modify, maintain and 
execute it from the terminal. 


4.2 CREATING A SOURCE PROGRAM 


To create a source program that will exist in a single source 
file (language environment), enter a program development language 
command with a user-specified filename. Source filename 
extensions are program-supplied and language-dependent. The 
language command entered must be consistent with the language of 
the source file. When a language command is entered, a file is 
allocated (if it does not already exist) with the user-specified 
filename and program-supplied filename extension, and the editor 
is loaded and started. If the file exists, it is set as the 
current program (Edit is not loaded.) 


Table 4-1 lists the program development language command syntax 
and program-supplied filename extensions. 


TABLE 4-1 PROGRAM DEVELOPMENT LANGUAGE COMMANDS 


eee See re ne ee eee Sh ete Sees aes mee a SUD TEE Suber came mmm) meee em cee cope Gm mE om tee es oe Gm? ee ee me ne ete is ES re oie ce eS Se GN ES me oe eS ee ee es 


H PROGRAM 
| DEVELOPMENT 
| FILENAME 
LANGUAGE | COMMAND SYNTAX | EXTENSIONS 


wo Sh Ss SS es SE ES SS SS EE Es SB ss 


(using optimizing 
compiler ) 


CAL./32 } CAL ({{voln:] filename] H . CAL 
| 
CAL Macro/32 {| MACRO [{[voln:] filename] | . MAC 
FORTRAN VII {| FORT [[{voln:] filename] { . FTN 
} (using development H 
} compiler ) H 
t- ] 
1 ' 
FORTRAN VII } FORTO [{[{voln:] filename] } .FTN 
1} 8 
! ! 
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TABLE 4-1 PROGRAM DEVELOPMENT LANGUAGE COMMANDS 


(Cont inued ) 
H PROGRAM 
i | DEVELOPMENT | 
{ FILENAME 
H LANGUAGE H COMMAND SYNTAX ;} EXTENSIONS | 
{ SSS EMBMEBTA CBE BBBEEEwEBSE SS EBS SS Ss EE ES SE 2 EO EE 2 EEE SE | 
i FORTRAN VII {| FORTZ [{[{voln:] filename] | .FTN H 
i (using the universal H H 
{ {| compiler) i H 
{| COBOL i COBOL [[voln:] filename] H CBL | 
t 1 i i 
’ t i ' 
|} REPORT i RPG [{voln:] filename] H RPG 1 
{ PROGRAM | 
{| GENERATOR 
( 1 t ' 
t ! J § 
| Pascal { PASCAL [[{voln:] filename] |} PAS | 


Program development language commands automatically set up 
certain processes that will be used for the remainder of the 
development effort. These processes are: 


@® assignment of the standard source file language extensions, 
@ the compiler or assembler to be used, 


e the standard Perkin-Elmer run-time libraries (RTLs) to be 
linked, and 


@ the language tab character, a back slash (\) and tab settings 
pertinent to the specified language (displayed when the editor 
is entered). 


These automatic specifications free the user from _ constantly 
typing or even remembering them. The user-supplied filename with 
the program-supplied extension will identify the source file 
throughout the program development session. 


Once the editor is loaded and started, the full range of edit 


commands are available to create the source file. See the OS/32 
Edit User Guide. 
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Example: 


In the following example, the FORTRAN language command entered 
with a user-supplied filename allocates an empty file, PROG1.FTN, 
then loads and starts the editor. The FORTRAN tab settings are 
set and displayed. The specified filename with the default 
extension is set as the current program and is always accessed 
and/or executed if the user does not specify another filename. 


*FORT PROGL 
x 


* New Language Environment -- FORTRAN VII D RO5-01 
x 
x 
x 


Editing new file -- PROG1.FTN (APPEND mode set) 
* 


PERKIN-ELMER OS/32 EDIT 03-145 RO3-O1 
OPTION TAB=\,7,73;OPTION INPLACE=OFF 
GET PROG1.FTN;OPTION COM=CON: ; AP 

> 


(edit session) 


»>SAVE* 

> END 

-WORK FILE = M67B:PROG1.000/P 

-RENUMBERED INPUT FILE AVAILABLE, M67B:PROG1.FTN/P 


A source file can also be created by entering a language command 
without a filename and then entering the EDIT command with a 
filename. The EDIT command allocates a file, then loads and 
starts the editor. All edit commands can be employed to create 
a source file. 


Example: 


In the sequence below, the FORT command creates the language 
environment. The EDIT command entered with PROG1 loads and 
starts the editor and allocates PROGI1L.FTN for the source file 
that will be created via the edit commands. PROGIL.FTN is saved 
and the edit session is ended. 
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*FORT 

x 

ba New Language Environment -- FORTRAN VII D RO5-01 
x 


*EDIT PROGL 


New current program - PROGL 


ee He He 


Editing new file -- PROG1.FTN (APPEND mode set) 
x 

PERKIN-ELMER OS/32 EDIT 03-145 RO3-O1 

OPTION TAB=\,7,73;OPTION INPLACE=OFF 

GET PROG1.FTN;OPTION COM=CON: ; 

1 > 


(edit session) 


>SAVE* 
> END 


4.2.1 Creating a Data File 


To create a data file, save the source program file to: disk and 
clear the edit buffer by deleting all lines currently in the 
buffer. 


Example: 


In this example, PROG1.FTN is saved and then cleared from the 
edit buffer. The edit APPEND command allows data to be entered 
in the data file. The data file is saved and the edit session is 
terminated with the END command. 


>SAVE* 
»DELETE 1- 
>AP 


(use the editor to create PROG1.DTA) 
>»SAVE PROG1.DTA 


> END 
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4.3 EXECUTING A PROGRAM 


The program development EXEC command loads and runs’ the current 
program. 


Example: 


The following example assumes that PROG1.FTN already exists as 
the current program. The EXEC command loads and runs the current 
program, PROG1.FTN, and displays a zero end of task code (if no 
errors occurred). A nonzero end of task code indicates an error 
was encountered. 


* EXEC 
*Execution of PROG1.FTN follows: 
-END OF TASK CODE=0 


4.4 MODIFYING A PROGRAM 


To modify a program, enter the appropriate language command with 
the filename of the source file to be modified. Enter the EDIT 
command to access the editor. 


Example: 


In the following example, the FORTRAN language command is entered 
with the filename PROG]. The editor is accessed via the EDIT 
command, and the name of the current program is displayed. The 
editor is used to modify the source file, PROG1. 


*FORT PROG1 
*EDIT 
-EDIT - PROG1.FTN 


(edit session to modify PROG1) 


>SAVE* 
>END 


4.5 REEXECUTING A MODIFIED PROGRAM 


When the EXEC command is issued, the source program is compiled, 
linked, and executed, creating object and image modules. If the 
source file is subsequently modified, the dates assigned to the 
previously compiled object and previously linked image modules 
will not be current (the object and image files will be older 
than the source file). 
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Dates and times (to the nearest minute) are assigned to source, 
object and image modules when they are created. The dates are 
stored in the system directory. 


The EXEC command causes the object and image modules to be date 
and timechecked. The source file is then compiled and/or linked 
if the object or image files are out of date or do not exist. 
The object module is assumed to be out of date if it is older 
than the source module, or if the dates and times of creation of 
the source and object modules are equal to the nearest minute. 
The image module is assumed to be out of date if it is older than 
the object module or if the dates and times of creation of the 
object and image modules are equal to the nearest minute. The 
EXEC command then loads and runs the image program. 


Examples: 


The following is an example of output from the EXEC command when 
compilation and link-edit are required. This occurs if no object 
file exists or if the object file is out of date. 


*EXEC 

* Compilation required 

FORTRAN-VIID RO5-01.00 

MARYANN -END OF TASK CODE= 0 PROCESSOR=0.158/0.731 
PERKIN-ELMER OS/32 LINKAGE EDITOR 03-242 RO1-00 
.-MARYANN -END OF TASK CODE= 0 PROCESSOR=3.197/2.442 
x 


* Execution of PROG1.FTN follows: 
x 
This is a demonstration of the EXEC command 
STOP 
MARYANN -END OF TASK CODE= 0 PROCESSOR=0.010/0.016 


The following is an example of when only link-edit is required. 
This occurs if no image file exists or if the image file is out 
of date. 


* EXEC 
PERKIN-ELMER OS/32 LINKAGE EDITOR 03-242 RO1-00 
MARYANN -END OF TASK CODE= 0 PROCESSOR=3 .196/2.466 


x 


is Execution of PROG1.FTN follows: 
x 
This is a demonstration of the EXEC command 
STOP 
MARYANN -END OF TASK CODE= 0 PROCESSOR=0.010/0.016 


In the following example, the EXEC command executes all the 
modules as one program and displays end of task code = 0 after 
successful execution. 
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* EXEC 
* 


* Execution of PROGL.FTN follows: 
* 
This is a demonstration of the EXEC command 
STOP 
MARYANN -END OF TASK CODE= 0 PROCESSOR=0.011/0.016 


In all three cases, PROG1.FTN was previously established as the 
current prograrm in the proper environment. 


The program development RUN command can also be used to execute 
a program. The RUN command does not datecheck, compile or link. 
It simply runs a program that was already compiled and linked. 


Example: 
*RUN PROG1 
x 
x Execution of PROG1 follows: 
x 
This is a demonstration of the RUN command 
STOP 
MARYANN -END OF TASK CODE= 0 PROCESSOR=0.010/0.016 


If the EXEC or the RUN command is entered without a filename, the 
current program is executed. If there is no current program, the 
following message is displayed. 


RUN 
x 


* Must have current program or specify file in order to run 
‘ 


If a user only wants to compile a program without linking or 
executing it, the program development COMPILE command can be 
used. The program development COMPLINK command compiles and 
links a program, if necessary, but does not execute it. The 
program development LINK command links the object program but 
does not execute it. These commands are explained fully in their 
respective sections. 


4.6 EXECUTING MULTIPLE PROGRAMS AS A SINGLE PROGRAM 


If a source program exists in multiple source files (multimodule 
environment), the user must include the file descriptors (fds) of 
each source file in an environment descriptor file (EDF). The 
EDF retains the identity of all the source files in the 
multimodule environment that will be used to create a program. 
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When using the program development ENV command, the user 
indicates that a source program exists in more than one file and 
is to be created in a multimodule environment. The ENV’ command 
creates the multimodule environment and allocates an EDF to 
contain the fds of the source files. 


Example: 


In this example the ENV command with the user-specified EDF name, 
ALLPROG, creates the multimodule environment. 


*ENV ALLPROG 
x 


New multimodule environment is ALLPROG.EDF 


x 

* 

* No current program 

* Link commands are standard 


No language extension is specified with the EDF filename since 
each module can be written in a different language. Attempting 
to enter an extension will cause an error. The user-specified or 
default volume is searched for ALLPROG. If it is not found, an 
empty file named ALLPROG is allocated, and the message, NEW 
ENVIRONMENT, is displayed. The EDF is now ready to receive the 
fds- of the multiple source files. The program development ADD 
command is used to add source program fds to the the muiltimodule 
environment. 


Example: 
In the following example, the multimodule environment is created 
and an EDF, ALLPROG, is allocated via the ENV command. The ADD 
command adds the fds (PROG1.FTN and PROG2.CBL) to the multimodule 
environment. 

*ENV ALLPROG 
New multimodule environment is ALLPROG.EDF 


No current program 
Link commands are standard 


* © eH HR 


*ADD PROG1.FTN 
*ADD PROG2.CBL 
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When the ADD command is entered with a user-specified fd, the EDF 
is searched for that fd. If the fd does not already exist in the 
multimodule environment, it is added. If it is already in the 
multimodule environment, the following message is displayed: 


*ADD PROG1.FTN 

x 

*  PROG1.FTN already exists in environment ALLPROG.EDF 
You must rename the file or remove the existing entry from the 
environment. 
The program development LIST command displays the fds in the 
multimodule environment, and the program development REMOVE 
command removes fds from the multimodule environment. 
Example: 
The LIST command displays PROG1.FTN and PROG2.CBL as the fds in 
the multimodule environment. The REMOVE command removes 
PROG2.CBL and the LIST command displays the contents of the 
multimodule environment. The EXEC command runs the program, 
ALLPROG. 

*LIST 


Current. multimodule environment is ALLPROG.EDF 


Current program = PROG2.CBL 
Link commands are standard 


ee ee Ke 


Contents of Environment file: 
PROG1.FTN 
PROG2.CBL, 


*REMOVE PROG2.CBIL 
*LIST 
x 


Current multimodule environment is ALLPROG.EDF 


x 

*% 

= Current program = PROG2.CBL 
x Link commands are standard 
* 

Contents of Environment file: 
PROG1.FTN 


XEXEC 
x 


* Execution of ALLPROG.EDF follows: 
x 


This is a demonstration of the EXEC command 
STOP 


MARYANN -END OF TASK CODE= 0 PROCESSOR=0.011/0.016 
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If the ADD or REMOVE command is entered without an fd or if the 
fd is incorrect, a brief description of the command is displayed. 


Not all program development commands are available in both 


language and multimodule environments. Table 4-2 shows the 
commands that are available in the environments. 


TABLE 4-2 PROGRAM DEVELOPMENT 
COMMAND AVAILABILITY 


ee ee re ee ee ee ee Gee eee SE mee ee ee ee ee eS ee a ee cee eet ee ee oe 


i H | MULTI- | 
i COMMAND | LANGUAGE |} MODULE |} 
j aS SS SsSSeSE SVs SVBwSET ETT EBS ES SSS SE BG GS ws 1 
i ADD i x 
H COMP ILE \ x H x | 
i COMPL,INK H x | b'4 H 
{ EDIT H x H x i 
i ENV i 1 x 
{| EXEC H x i x | 
{| LINK | x H x H 
i} LIST H H x { 
H REMOVE H { x | 
{i RUN i x i x i 


If a command that is meaningful only in a multimodule environment 
is entered in a language environment, the following message is 
displayed: 


* 


* Must be in a multimodule environment to use the command xxxxxxxx 
x 


The xxxxxxxx portion of this message is replaced with the name of 
the command. A brief description of the command is then 
displayed. 


In order to access a source program again, modify the source file 
and include it in a multimodule environment, enter the ENV 
command followed by the EDIT command and use the editor to modify 
the source file. 
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Example: 


In the following example, the multimodule environment is entered 
via the ENV command and the EDF name, ALLPROG. PROG1.FTN is 
added to the multimodule environment. The LIST command displays 
the filenames saved inthe EDF. The EDIT command accesses the 
editor to modify PROGL.FTN. When the edit session is ended, the 
EXEC command executes all the modules as one program, displaying 
an end task code of 0 after successful execution (if mo errors 
were encountered). 


XENV ALILPROG 

*ADD PROG] .FTN 

*LIST | 

** CURRENT ENVIRONMENT = ALLPROG 
-PROG2 . CBI. 

-PROG1.FTN 

*EDIT PROG1.FTN 

-EDIT PROG1.FTN 


(edit session) 


>SAVE* 

> END 

* EXEC 

-PERKIN-ELMER OS/32 LINKAGE EDITOR 03/242 ROO-OL 
-END OF TASK CODE = 0 

** EXECUTION OF ALLPROG FOLLOWS: 

-END OF TASK CODE = 0 

> 


4.7 HOW TO RECOVER FROM ERRORS 
If an error occurs in program compilation or execution, the 


process aborts and a nonzero end of task code and an error 
message are displayed. 


Example: 
* PROG1.FTN Compilation errors-listing on PR: 1 


Program development makes it easy for the user to recover from 
errors. Compile errors are printed in the listing of the source 
file containing the error. 


Use the editor to correct the error and reexecute the program. 
The EXEC command will recompile only the modified modules. 
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The EXEC command will occasionally cause a successfully compiled 
program to be recompiled. This happens when the creation times 
of the source and object files are equal (to the nearest minute). 
Any program that is recompiled will be relinked. A program that 
is successfully compiled and linked may be unexpectedly relinked 
by the EXEC command if the creation time of the object and image 
files are equal (to the nearest minute). 


See the O0S/32 Link Reference Manual for an explanation of Link 
error messages. 


4.8 ASSIGNING LOGICAL UNITS 


Program development defines and sets global variables that are 
associated with particular devices. These devices have default 
logical unit (lu) assignments. The global variable names’ and 
settings are displayed when the user signs on. Table 4-3 shows 
the variable names, their default settings and lu assignments. 


TABLE 4-3 PROGRAM DEVELOPMENT 
DEFAULT VARIABLE SETTINGS 
AND LU ASSIGNMENTS 


VARIABLE NAME | DEVICE ; IU | 
| sSySIN. | GON? | 
| SSYSOUT | CON: | 2 | 
| SSYSPRT | PR: | 3 | 
| SSYSCOM | CON: | 5 | 
SSYSMSG CON 7 ! 


Before running a program, ensure that the default variable and lu 
settings are appropriate. The input device can be changed from 
the console (default) to a preallocated file. 


Example: 
*SSYSIN FILE.IN 


Listings can be sent directly to a file rather than to the 
printer (default). 
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Example: 
*SSYSPRT FILE.OUT 


The user has the option to specify lu assignments unique to a 
particular session. This is accomplished by creating a file, via 
the editor, that contains the new lu assignments. This file must 
be saved with the extension .ASN, and the last line in the file 
must be a $EXIT statement. The program development software will 
first search for a file with the extension .ASN. If no file is 
found, the default lu assignments are used. The HELP command 
provides all the information needed to create a new assignment 
file. 


Any variable settings you change supercede the default variable 
settings and are in effect until you change them again or sign 
off. 

4.9 PROGRAM DEVELOPMENT COMMANDS 

This section describes the functions of each of the _ following 
program development commands: 

e@ ADD 

@ COMPILE 


@ COMPLINK 


e EDIT 

e® ENV 

@ EXEC 

@ LINK 

e LIST 

@ REMOVE 
@ RUN 
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4.9.1 ADD Command 


The ADD command adds the new source file fds to the multimodule 
environment. These fds are retained in the EDF. 


Format : 
ADD source-fd [, compile-css] [,arg,,.. -arg7] 
Parameters: 
source-fda is the file descriptor of the source file to 
be added to the EDF file. 
compile-css specifies the name of the command substitution 
system (CSS) file to be used in the 
compilation of the source-fd file. 
. arg can be up to seven compilation arguments. 


These arguments are dependent upon the 
language of the source file. The user’ should 
refer to the appropriate language environment 
commands for details. 


Functional Details: 


The ADD command causes the filename of the specified source-fd to 


be searched for in the current’ EDF. If the filename is not 
found, the source-fd is added to the multimodule environment that 
was previously invoked by the ENV command. If a matching 


filename (regardless of extension) currently exists in the 
environment, the file will not be added to the EDF and the 
following message is displayed: 


* FILENAME already exists in environment edfname.EDF 


If the filename is omitted or is in an incorrect format, this 
message is displayed, followed by the HELP feature of the ADD 
command: 


* 
* ADD requires at least one argument 
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If the filename is entered without an extension, the following 
message is displayed, followed by the HELP feature of the ADD 
command: 


*% 


* Must specify extension or compile css name 
x 


Any file added to the EDF file becomes the current program. 


The compile-css parameter must be used if the extension of the 
specified file differs from the language extensions listed in 
Table 4-1. If this parameter is omitted when using a nonstandard 
extension, a search is made for a file named COMPext.CSS (where 
ext is the nonstandard extension) and the following message is 
displayed: ‘ 


x 


* Compile css COMPext.CSS does not exist 
* 


The alternate CSS cannot be specified by just a volume name. It 
must contain at least a filename. 


The ADD command is valid only in a multimodule environment. An 
error message is output when an attempt is made to use this 
command in a language or null environment. 


Examples: 


The following example demonstrates the addition of three _ source 
files to the current multimodule environment EDF: 


X*ADD DEMO] .FTN 
*ADD DEMO2 .CAL 
*ADD DEMO3 .RPG 


The following example demonstrates the attempted addition of an 
fad for which a matching filename already exists within the EDF. 
As shown in the example, the filename must be unique. When 
adding an fd to the EDF, different extensions will not suffice. 


*ADD DEMO3.CBI 
* 


* DEMO3.CBL already exists in environment ANYTHING.EDF 
x 
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This example demonstrates the message displayed when the ADD 
command is issued without an fd. This message is immediately 
followed by the HELP feature for the ADD command. 


*ADD 
* 


* ADD requires at least one argument 
x 


The following example illustrates the message displayed when the 
ADD command is issued with a filename only (no extension 
specified). This message is immediately followed by the HELP 
feature of the ADD command. 

*ADD PROG4 

* 

* Must specify extension or compile css name 


* 


In the following example, an fd with a nonstandard extension is 
specified, but the compile-css parameter is not used to pass the 
name of the required compilation CSS. 


*ADD DEMO4 .DIF 
* 


Compile css COMPDIF.CSS does not exist 
x 


In this example, an fd with a nonstandard extension is added to 
the EDF file. The name of the CSS procedure required to compile 
this file is passed via the compile-css parameter. 


*ADD DEMO4.DIF ,OTHRCOMP .CSS 
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4.9.2 COMPILE Command 


The COMPILE command compiles a source file or group of source 
files when in a language, multimodule or null environment. The 
COMPILE command conditionally compiles when the ALL parameter is 
specified in the multimodule environment. The COMPILE command 
does not execute a program. 


Format: 


filename 


COMP ILE ALL [st-ops] 2 [, loadinc] [,calops] 


E[a] | |G copy-ta] 5 mlbcss]} 


Parameters: 


filename specifies a l1- to 8-character alphanumeric 
filename of the source file to be compiled 
and/or assembled. The extension for the 
source file fd is assigned depending upon the 
current language environment. If the 
extension is other than the default of the 
current environment, or only one file of a 
multimodule environment is to be compiled, the 
extension must be specified. 


ALL specifies that all source files in the EDF 
file are to be compiled. If neither filename 
nor ALL is specified, the current program is 
the default. This only applies in a 
multimodule environment. 


st-ops can be used to specify START options for _ the 
compilation process. If this parameter is 
omitted, START options default by language. 


List-op is the fd of an existing file to which the 
compilation listing is sent. 


P indicates that the compilation listing is to 


be sent to the file or device specified by the 
SSYSPRINT global variable. 
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L indicates that a new file, currprog.LST, is to 
be allocated to receive the compilation 
listing. If A is included, the listing is to 
be appended to the existing currprog.LST file. 


E indicates that a new file envir.LST, is to be 
allocated to receive the listing. If A is 
included, the listing is appended to the 
existing envir.LST file. This only applies in 
a multimodule environment. 


loadinc specifies the segment size increment to be 
used for compilation or assembly. The default 
is by language. 


calops specifies the START options for environments 
other than CAL, FORT and PASCAL. The default 
is by language. 


copy-fd specifies the name of the copy file (if 
required) to be assigned to lu7 for assembly. 


mlbcss used in-the MACRO environment to specify the 
CSS file to be used in assigning the required 
library units for Macro/32. 


Functional Details: 


A successful compilation ends with a zero end of task code. An 
end of task code other than zero indicates a compilation error 
that will be printed on the listing created as a result of 
compile. 


If the list-op parameter is omitted, the value specified by the 
SSYSLST global variable is used to determine the destination of 
the compilation listing. 


If the environment is not set and no filename is specified when 
the COMPILE command is entered, the following message _ is 
displayed: 


Filename must be specified or current program established 
before compilation 


e &@ He MH 


If no environment is set and a filename is specified, the 
following message is displayed: 


* 
* Must be in environment or specify extension to compile 
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If a specified filename does not exist, the following message _ is 
displayed: 


x 


* FILENAME not found in environment edfname.EDF 
x 


The COMPILE command functions are illustrated in Figures 4-1 and 
4-2. 
Examples: 


No environment is set and no filename is specified. 


* COMP ILE 
* 


* Filename must be specified or current program established 
* before compilation 
x 


In the following example, no environment is set but a filename is 
specified. 

*COMPILE DEMO1] 

* 

* Must be in environment or specify extension to compile — 


x 


In the following example, the environment is set (to FORT) but 
the specified file does not exist. 


*COMPILE NOSUCH 
% 


* NOSUCH.FTN not found in environment ALLPROG.EDF 
* 


In the following example, the command is issued with the proper 
environment established, and the specified file exists. 


*COMPILE DEMO] 

FORTRAN-VIID RO5-00.00 

-MAIN NO ERROR(S) TABLE SPACE USED: 1K 
BARNEY —-END OF TASK CODE= 0 PROCESSOR=0 .632/0.117 
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SOURCE MODULES BEFORE COMPILE 


|PROG1.FTN} 
->| 
| 6/20 | 


PROG2.CBL} 


{ 
| 
->| 
| 


OBJECT AND SOURCE MODULES AFTER COMPILE 


—_— ee ee ee oe ee ee ee ee ee ee ee ee ee ee 


{PROG1.FTN} |PROG1.OBJ} 
t J i ] 
1 ' § j 
6/20 jj j 6/20 |} 
mana an--- 0-H ----- NO 
EXECUTION 

{PROG2.CBL| |PROG2.OBJ} 
{ | 1 ! 
1 t ’ J 
| 6/20 $ | 6/20 } 

A 

pcan eter Sea a 

COMP ILE 
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Figure 4-1 COMPILE Command Functions in the Language 
Environment 
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SOURCE AND OBJECT MODULES BEFORE COMPILE ALL 


H ! !PROG1.FTN! 

t r] i] { 

i] i] ! i] 

H 1->| 6/20 } 
!ALI.PROG.EDF! --------- 

i H 

H Dees ae SSeS aS 
H '~>|]PROG2.CBL} }|PROG2.OBJ} 
| ; | 
H rf 6/20 }{ | 6/15 | 


SOURCE AND OBJECT MODULES AFTER COMPILE ALL 


{PROG1.FTN} 
{ ( 
! (] 
6/20 | 
1PROG2. CBI} 1 PROG2 .OBJ } 
jaa=) | 
H 6/20 | | 6/15 H 
A I 
ene ieee a ee | 
DATECHECK 
}PROG1.FTN} 'PROG1.OBJ} 
jee=>] 
\ 6/20 H H 6/20 H 
---- ae sooleniantontententententans NO 
EXECUTION 
\PROG2.CBL} 'PROG2 .OBJ} 
==> | 
H 6/20 i i 6/20 H 
i A 
Pca a a a a aca 
COMPILE 


Figure 4-2 COMPILE Command Functions in the Multimodule 
Environment 
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4.9.3 COMPLINK Command 


The COMPLINK command performs a conditional compile and a 
conditional link by datechecking source, object and image modules 
in language, multimodule or null environments. If all modules 
are up to date, this command does not perform any function. This 
command does not execute the program. 


Format: 


res Pp [; loadinc] [,map ] 


E [A] [,work ] [-worklim] 


Parameters: 


filename is a l1- to 8-character alphanumeric filename 
of the source file to be compiled and/or 
linked. If the filename is specified and has 
no extension or has the extension of the 
current language environment, it is checked 
for existence and becomes the current program. 
If the filename is omitted (as it must be in 
a multimodule environment), the current 
program or environment is the default. 


st-ops can be used to specify START options for the 
compilation process. If this parameter is 
omitted, START options default by language. 


List-op is the fd of an existing file to which the 
compilation listing or Link output is sent. 


P indicates that the compilation listing is to 
be sent to the file or device specified by the 
SSYSPRINT global variable. 


L indicates that a new file, currprog.LST, is to 
be allocated to recieve the compilation 
Listing. If A is included, the listing is to 


be appended to the existing currprog.LST file. 
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E indicates that a new file, envir.LST, is to be 
allocated to receive the listing. If A is 
included, the listing is appended to the 
existing envir.LST file. This only applies in 
a multimodule environment. 


loadinc specifies the segment size increment to be 
used for compilation or assembly. The default 
is by language. 


map is the fd of an existing file to which the 
Link map is sent. If this parameter is 
omitted, the default is to list-op. 

work indicates memory workspace is to be allocated 
to atask. The default is dependent upon the 
language. 

worklim indicates the upper boundary of the _ load 


increment size. 


Functional Details: 


When the COMPLINK command is used in a multimodule environment, 
all the fds contained in the EDF are datechecked, compiled and/or 
linked. 


If the object file, filename.OBJ, does not exist or is older than 
the source file, it will be recompiled. If any recompilation is 
required, a task does not exist, or the task file is older than 
any object file, 08/32 Link is invoked to produce a new task. _ 


When a Link command file, filename.LNK (envir.LNK for multimodule 
environments) exists, it is unconditionally used; otherwise, one 
will be built automatically and discarded after use. The BLINK 
command enables the user to build a permanent command file. It 
can then be edited to incorporate any special linking 
requirements. 


If the list-op parameter is omitted, the value specified by the 
SSYSLST global variable is used to determine the destination of 
the compilation listing. 

If there is a compilation error, the process ends with a nonzero 


end of task code, the Link procedure never starts, and the 
process is aborted. The following message is then displayed: 


* FILENAME Compilation errors-listing on (device): 
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If the specified source file is not found, the COMPLINK sequence 
terminates and the following message is displayed: 


> 4 
* FILENAME not found in environment edframe.EDF 


If any arguments are specified in a multimodule environment, the 
following message is displayed: 


First argument filename is not permitted when in a 
multimodule environment. Environment name is 
always used. 


ee He He 


The COMPLINK command functions are shown in Figures 4-3 and 4-4. 
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Figure 4-3 COMPLINK Command Functions in the Language 
Environment 
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Figure 4-4 COMPLINK Command Functions in the Multimodule 
Environment 
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4.9.4 EDIT Command 


The program development language commands load and start the 
editor for 
enter the EDIT command to create or modify a source or data file. 


Format: 


cea i 


Parameters: 


filename 


INPLACE 


COMMAND 


LENGTH 


PROTECT 


you 


to create a source or data file. You can also 


ee 


filename i COMMAND=command 


LENGTH at 


cong 


specifies a 1l- to 8-character alphanumeric 
filename of the source file to be created or 
edited. If this parameter is omitted, the 
current program is the default. 


editing is done in place if the edit file 
exists. 


specifies the first edit command to be 
performed on the source file if the file 
exists. If the file specified for editing 
does not exist, it is allocated and COMMAND= 
is forced to APPEND. 


allocates the edit file with the specified 
record length if file does not exists. The 
default is 80. 


protection keys of the edit file are cleared 


during editing, but are set to FFOO after 
editing is completed. 
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Functional Details: 


The EDIT command can be used whether or not any environment has 
been established. If no environment has been established, the 
source file is simply edited. 


A language command entered with a filename loads and starts’ the 
editor if the file does not exist. If the language command is 
entered without a filename, the EDIT command can be entered with 
a filename to access’ the editor and create or modify a source 
file. 


The user can simply type EDIT, which causes the editor to be 
loaded and started without the intervention of the program 
development system. If no current program is established, the 
following message is displayed to prompt the user to supply the 
desired filename: 


GIVE FITLENAME= 


If this command is entered in a NULL environment, the _ tab 
character is set and displayed, but the language tabs are not 
set. 


If this command is entered with a filename not contained in a 
multimodule environment, the following message is displayed: 


* FILENAME not in edframe.EDF environment-—-will edit anyway 


If this command is entered without a filename in the multimodule 
environment and there is no current program, the following 
message is displayed: 


Enter name of file to be edited 


x 
x 
* or * to just start EDITOR 
* 

GIVE FILENAME= 
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If the EDIT command is entered while a current program is 
established, the current program is made available for editing. 
For example, if the language environment is set to FORT with a 
current program of PROG1.FTN, the EDIT command produces the 
following results. 


*EDIT 
PERKIN-ELMER OS/32 EDIT 03-145 RO3-O1 
OPTION TAB=\,7,73;OPTION INPLACE=OFF 
GET PROG1.FTN;OPTION COM=CON: ;SC 

L baw GO RIGHT AHEAD AND 

2 >C ENTER THE PROGRAM 

3 »C YOU ARE DEVELOPING. 
{UNABLE TO TYPE FULL SCREEN 
> 


If no current program is established, the result of the EDIT 
command is the following: 


*EDIT 

x 

* Enter name of file to be edited 
* or * to just start EDITOR 


* 


- GIVE F ILENAME= 


If the user responds at this point by supplying an fd, the editor 
either retrieves an existing file or allocates a new one, 
depending on the existence or absence of the specified file. 


GIVE FILENAME=ANYTHING. EXT (file does not exist) 
x 


* Editing new file -- ANYTHING.EXT (APPEND mode set.) 
* 
PERKIN-ELMER OS/32 EDIT 03-145 RO3-O1 
OPTION TAB=/;OPTION INPLACE=OFF 
GET ANYTHING.EXT;OPTION COM=CON: ; AP 
1 > 


or 
GIVE FILENAME=ANYTHING.EXT (file exists) 
PERKIN-ELMER OS/32 EDIT 03-145 RO3-0O1 
OPTION TAB=/;OPTION INPLACE=OFF 
GET ANYTHING.EXT;OPTION COM=CON: ; AP 
l > ETCETERA 


If no extension is specified, the default extension for the 
current language environment is assigned. If no language 
environment has been established, no default extension is 
assigned and the source file is edited. 
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If the user enters the asterisk (*) character, the system 
responds in the following manner: 


GIVE FILENAME=* 
* 


* Entering EDITOR with no file (in APPEND mode) 
x 
PERKIN-ELMER OS/32 EDIT 03~-145 RO3-0O1 
OPTION COM=CON: ; AP 
1 > 


If a filename other than the filename of the current program is 
specified, that file is established as the current program and is 
made available for editing (provided the file has the proper 
extension). For example, if the current language environment is 
FORT, and no current program exists or the current program is 
other than PROG1.FTN, the following EDIT command will produce the 
indicated response. 


*EDIT PROG1 


x 


* New current program - PROG1L 
x 
PERKIN-ELMER OS/32 EDIT 03-145 RO3-O01 
OPTION TAB=\,7,73;OPTION INPLACE=OFF 
GET PROG1.FTN;OPTION . COM=CON: ;SC 

lL C GO RIGHT AHEAD AND 


2 C ENTER THE PROGRAM 
3° .€ YOU ARE DEVELOPING. 
!UNABLE TO TYPE FULL SCREEN 


> 


For information on the edit commands, see the 0OS/32 Edit User 
Guide. 
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4.9.5 ENV Command 


The ENV command entered with an EDF name creates or sets a 
multimodule environment and allocates the user-specified EDF, if 
necessary. This command can also be used to clear or display the 
current environment. 


Format: 
NULL 
ENV 
filename [, subenv | 

Parameters: 

NULL clears - the language or mult imodule 

environments. 
filename is a 1l- to 8-character alphanumeric name 


specifying the EDF , filename.EDF, which 
creates and/or sets multimodule environments. 
The EDF extension is automatically appended 
and must not be entered by the user. The 
optional subenv permits users to specify 
subenvironments within language or multimodule 
environments. 


Functional Details: 
If the filename parameter is entered with an extension other than 
-EDF, the following message is displayed: 


* Environment name must have no extension or .EDF 


If the ENV command is entered without a parameter, the name of 
the current environment is displayed: 


* Current multimodule environment is xxxxxxxx 


If the environment was not set or the NULL parameter was 
specified at signon, the following message is displayed: 


* No current environment 
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4.9.6 EXEC Command 
The EXEC command will compile and link a program in the language 
or null environments or compile and link all modules ina 


multimodule environment if they are outdated. When the _ image 
program is current, it is loaded and run. 


Format: 


filename 
EXEC _¢|Lxrunops] L runincr] 


Parameters: 


filename is a 1l- to $8-character alphanumeric name 
specifying the program to be run. If this 
parameter is omitted, the current program or 
EDF name is the default. 


runops is used to start the resulting task. 

runincr once the object files are linked to create the 
task, the task is loaded with a load 
increment, which is set by runincr. 


Functional Details: 


The source file is compiled if no object file exists, or if it is 
not older than the object file. 


The object file is linked if no image file exists, or if it is 
not older than the image file. 


When the EXEC command is entered in a multimodule environment, 


all modules contained in the EDF are compiled and linked if they 
are outdated. The task is then loaded and run. 
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If a link error occurs, the following message is displayed: 
* Link errors--listing on device: 
The filename must not be specified ina multimodule environment 


since the entire environment is assumed. 


The EXEC command functions are shown in Figures 4-5 and 4-6. 
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Figure 4-5 EXEC Command Functions in the Language 
Environment ~— 
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Figure 4-6 EXEC Command Functions in the Multimodule 
Environment 
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4.9.7 LINK Command 


The LINK command links the object module to yield the _ image 
module in language, multimodule or null environments. If no 
object module exists, the LINK command causes the source module 
to be compiled to yield the object module. The LINK command does 
not datecheck, load or execute a program. 


Format: 


filename list-op 


g [map | [;work] [,worklim] [ams] 
L{A] 
E(a] 


LINK 


Parameters: 


filename is a 1l- to 8-character alphanumeric name 
specifying the files to be compiled and/or 
linked. If this parameter is omitted, the 
current program is the default. A filename is 
meaningful only in a language environment. 


List-op is the fd of an existing file to which the 
compilation listing is sent. 


P indicates that the compilation listing is to 
be sent to the file or device specified by the 
SSYSPRINT global variable. 


L indicates that a new file, currprog.LST, is to 
be allocated to receive the compilation 
listing. If A is included, the listing is to 
be appended to the existing currprog.LST file. 


E indicates that a new file, envir.LST, is to be 
allocated to receive the listing. If A is 
included, the listing is appended to the 
existing envir.LST file. This only applies in 
a multimodule environment. 


map is the name of an existing file which will 


receive the Link map. If this parameter is 
omitted, list-op is the default. 
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work is used to allocate memory workspace to a 
task. If this parameter is omitted, the 
default is by language. 


worklim specifies the upper boundary of the _ load 
increment size for a task. 


dams is the name of the data management system 
(DMS) run-time library (RTL) segment to be 
resolved against and can only be used with DMS 
subenvironments. Defaults to DMS.RTL. 


Functional Details: 


When the LINK command is entered in a multimodule environment and 
no object module exists, all source file fds contained in the EDF 
are compiled. The resulting object modules are then linked. 


The LINK command also links all of the standard Perkin-Elmer RTLs 
specified by the language extension assigned when the source file 
was created. 


4.9.7.1 Link Sequences 


The user can specify a Link sequence by building a Link file that 
must have the extension’ .LNK. When the link sequence is 
specified, the system searches the default user volume for a file 
with the .LNK extension and a filename matching the EDF name or 
the filename of the current program. When found, it is executed. 


Example: 


*BUILD JOB.LNK 
B>ESTABLISH TASK 

B> INCLUDE PROG1.0BJ 

B> INCLUDE PROG2.OBJ 
B>LIBRARY F7RTL,COBOL.LIB 
B>MAP PR: ,AD,AL,XREF 
B>BUILD PROG. TSK 

B>END 

B>ENDB 


If the user-specified Link file is not found, the system uses the 
default link sequence. There is a default link sequence for each 
language environment. Following is an example of a default 
FORTRAN link sequence: 


»ESTABLISH TASK 

>INCLUDE current program 

> INCLUDE LIBRARY F7RTL.OBJ/S 
>OP DFLOAT, FLOAT, WORK=X3072 
»BUILD filename. TSK 

>END 
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The LINK command functions are shown in Figures 4-7 and 4-8. 
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Figure 4-7 LINK Command Functions in the Language 
Environment 
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Figure 4-8 LINK Command Functions in the Multimodule 
Environment 
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4.9.8 LIST Command 


The LIST command lists the fds of all the multimodule environment 
programs that are contained in the current EDF. 


Format: 


filename 
LIST 
x 


Parameters: 


filename is a filename of one of the members of the 
current EDF. If a filename is specified, and 
special compiler arguments applicable to the 
source file, the special compile CSS (if any) 
are displayed. 


* indicates that compiler arguments and special 
compile CSSs are to be displayed for all 
members of the current EDF. 


Functional Details: 


The LIST command causes a listing to be sent to the list device 
specified by SSYSPRT when 1u assignments were made. The user 
must be in a multimodule environment to use the LIST command. If 
not, an appropriate message is displayed. 


When the user is in a multimodule environment, the LIST command 
can be used without parameters to display pertinent current 
information and the fds of all files in the environment. If a 
file with a nonstandard extension is contained within the 
environment, the name of the required compilation CSS is also 
displayed. 
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*LIST 
Current multimodule environment is ANYTHING.EDF 


Current program-—-DEMO4 .DIF 
Link commands are standard 


et & He HM HR FH 


Contents of Environment file: 

DEMO1.FTN 

DEMO2 , CAL 

DEMO3 . RPG 

DEMO4 .DIF compiled with OTHRCOMP 


If a particular fd is specified with the LIST command, the file, 
its compile arguments and the name of the nonstandard compilation 
CsS (if any) are displayed. This information is displayed for 
all members of the environment if an asterisk (*) is entered with 
the LIST command. 


*LIST * 

* 

* Current multimodule environment is ALLPROG.EDF 
* 

* Current program = DEMQ3.PAS 

* Link commands are standard 

x 


Contents of Environment file: 


DEMO1.FTN compiled with OTHRCOMP 
compile arguments = "LCNT=55",TRACE,WARN,"",XREF,, 
DEMO 2 . CAL 

compile arguments = "",SCRAT,SQUEZ,"",FREEZE,, 
DEMO3 . PAS 


NW 


compile arguments ne 


yore 


If the LIST command is entered and no fds are in the multimodule 
environment, an appropriate message is displayed. 
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4.9.9 REMOVE Command 
The REMOVE command deletes specified source fds from the current 
multimodule environment. 
Format: 
REMOVE fd 


Parameters: 


fd is a file descriptor of a source file 
contained in the EDF. 


Functional Details: 


When the REMOVE command is entered, the current EDF is’ searched 
for the specified fd. When found, the fd is removed from the 
multimodule environment. If the fd is not found, the following 
message is displayed: 


* 


* FILENAME not found in environment edfname .EDF 
* 


The REMOVE command is only valid in a multimodule environment, 
otherwise an error message is output when an attempt is made to 
use it in a language or null environment. 
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4.9.10 RUN Command 


The RUN command loads and runs the image program in language and 
multimodule environments. This command does not datecheck, 
compile or link. 


Format: 


filename 
RUN [,st-ops ] 
<c fn: 


Parameters: 


filename is a l- to 8-character name specifying the 
image module. If this parameter is omitted, 
the default is the current program. 


st-ops is used to start the task. 


Functional Details: 


If a filename is not entered with the RUN command, the following 
message is displayed: 


x 


* Must have current program or spécify file in order to run | 


* 


If the specified file does not exist, the following message is 
displayed: 


x 
* CANNOT RUN -- filename.TSK DOES NOT EXIST 
* 


Figures 4-9 and 4-10 illustrate the RUN command functions. 
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IMAGE MODULE BEFORE RUN 


PROG1.TSK} 


i] 
i 
i 
IMAGE MODULE AFTER RUN 


| PROG1.TSK} 

i-> TASK 

i 6/20 } EXECUTION - 
RUN 


IMAGE MODULE BEFORE RUN 


| 
{| ALLPROG.TSK } 
| 
| 
! 
| 


IMAGE MODULE AFTER RUN 


| 

| 

{-> TASK 
|ALLPROG.TSK} EXECUTION 
! ! 
' 1 
1 


Figure 4~10 RUN Command Function in the Multimodule Environment 
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Table 4-4 summarizes the functions of the commands 
compile, link and run a program. 


TABLE 4- 


4 PROGRAM DEVELOPMENT COMMANDS THAT 
COMPILE, LINK AND EXECUTE 


used to 


eee A OS ES SPE A ONY SS Same SEED ENCE SUED GUE OER Gene GET Grek GENE SUED SE: SUED ome mye eS Sy Oo mS eee eS One Me Gere GS me ie GE SE EEE wee SUES Gey ee SE cme cm Ome ee tes 


COMMAND  } 


| 
| 
{| COMPILE | 
t 
! 
t 


FUNCTION 


SSs SSS SSS SBT SESCECSBASSoSSTSEBSswS SSCS SSCs ICES Sss SSS SST se 


Compiles source module into object 
module when object module does not 
exist or is outdated. 


Datechecks source, object and image 
modules and compiles and/or _ links 


them, if outdated, to form image 


program. 


Compiles source module into object 
module when object module does not 
exist. Then links object module and 


standard RTLs to form image program. 


Datechecks image, object and source 
modules. Compiles and links them if 


outdated. Loads and runs up to date 


image program. 


Loads and runs image program without 


datechecking, compiling or linking. 
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4.10 SAMPLE PROGRAM DEVELOPMENT SESSIONS 


This section presents coding examples using the 
development commands. 


*FORT TEST 
** NEW PROGRAM 
-EDIT 


(edit session) 


SAVE* 
> END 
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program 


Create FORTRAN language 
environment with the 
FORT language command 


Specify TEST as filename 


to be allocated 


FORT command loads and 


starts editor with 


TEST.FTN as current 


program 


. (compilation sequence) 


*SSYSIN CON: 


*SSYSOUT CON: 
*SSYSLIST PR: 
*EXEC TEST 

—-FORTRAN: TEST 


** COMPILE ERRORS, LISTING ON PR: 


*EDIT 
-EDIT - TEST.FTN 


(edit session) 


SAVE* 
>END 


* EXEC 
-FORTRAN - TEST 


-END OF TASK CODE=0 


-~LINK - TEST 


(link sequence) 


-END OF TASK CODE=0 


** EXECUTION OF TEST FOLLOWS: 


(execution sequence) 


-END OF TASK CODE=0 


Define and set new global 
variables 


Execute TEST. FIN 
Compile TEST.FTN 
Compilation errors in TEST 


Find and correct errors 


Execute current program 


Compile 


Sucessful compilation 
Link the newly created 
object module TEST.OBJ 


Successful link, new task 
now exists 


Run the new task TEST.TSK 
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* EXEC 


** EXECUTION OF TEST FOLLOWS: 


(execution sequence) 


-END OF TASK CODE = 0 
*RUN 


** EXECUTION OF TEST FOLLOWS: 


(execution sequence) 


-END OF TASK CODE=0 


*EXEC NEWPROG 
** FILE NEWPROG.FTN NOT FOUND 


*MACRO 


*EXEC NEWPROG 
-MACRO - NEWPROG 
-CAL - NEWPROG 
~LINK - NEWPROG 


(link sequence) 


** EXECUTION OF NEWPROG FOLLOWS: 


(execution sequence) 


-END OF TASK CODE#0 
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Successful execution 
Reexecute 

Ensure program is compiled 
and linked 

Compile, link unnecessary 
Object and image up to date 


Successful execution 


Rerun 


Execute NEWPROG 

System finds NEWPROG.MAC 
Cannot find NEWPROG.FTN 
Specifiy MACRO command to 
access NEWPROG.MAC and enter 
a new language environment 


Execute NEWPROG.MAC 
Expand 

Assemble 

Link 


Successful execution 


*EDIT Edit current program 
EDIT-NEWPROG . MAC 


(edit session) 


SAVE * 


>END 

* EXEC Execute current program 
-MACRO - NEWPROG Expand 

-CAL - NEWPROG Assemble 

-~LINK - NEWPROG Link 


(Link sequence) 


** EXECUTION OF NEWPROG FOLLOWS: 


. (execution sequence) 


~-END OF TASK CODE=0 Successful execution 


Create multimodule envi- 
ronment with ENV command 


*ENV BIGTASK BIGTASK.EDF allocated 
**k NEW ENVIRONMENT 
*ADD SUB.CAL Add 3 module names to EDF 


*ADD MACRTY.CAL 

*ADD FTOR.FTN 

*LIST List all modules in EDF 
** CURRENT ENVIRONMENT=BIGTASK. EDF 

-SUB.CAL 

-MACRTY . CAL 

-FTOR.FTN 

*ADD SUBFUNC.FTN Add 2 more modules to EDF 
*ADD YSUB.MAC 
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*REMOVE SUB.CAL 
*FORT SUBFUNC 
-EDIT - SUBFUNC 


(edit session) 


*EDIT YSUB 


(edit session) 


*ENV BIGTASK 


* EXEC 

-FORTRAN - FTOR. FTN 
-~FORTRAN - SUBFUNC.FTN 
-MACRO - YSUB.MAC 

-CAL - MACRTY.CAL 
-LINK - BIGTASK 


(link sequence) 


END OF TASK CODE=0 


** EXECUTION OF BIGTASK FOLLOWS: 


(execution sequence) 


-END OF TASK CODE=2 
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Remove fd from EDF 


Make changes to SUBFUNC.FTN 


Make changes to YSUB.MAC 


Create multimodule envi- 
ronment 

Execute modules remembered 
in BIGTASK.EDF 

FTOR.OBJ and YSUB.OBJ 
modules are outdated 


Link BIGTASK 


All objects are linked; 
appropriate RTLs are also link 


Execution errors traced to YSU 


*MAC Create language environment 
*EDIT YSUB Correct errors in YSUB.MAC 


(edit session) 


SAVE* 


>END 

*ENV BIGTASK Enter multimodule environment 
*kEXEC 

-MACRO: YSUB .MAC YSUB.MAC object is outdated 


Expand, assemble and link-edi' 
-CAL - YSUB.MAC 


-LINK - BIGTASK 


(link sequence) 


** EXECUTION OF BIGTASK FOLLOWS: 


(execution sequence) 


-END OF TASK CODE=0 
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CHAPTER 5 
MULTI-TERMINAL MONITOR (MTM) BATCH PROCESSING 


5.1 INTRODUCTION 


In addition to interactive processing capabilities, MTM also 
supports concurrent batch processing, allowing the user to run 
multiple batch jobs from a single batch queue. This feature 
enables the user to effectively utilize the capabilities of the 
system with minimal interference to the interactive users. 


The number of concurrent batch jobs allowed at any time under MT 
is set by the operator from the system console. This number 
cannot exceed 64. If more batch jobs are submitted than there 
are active job streams, MTM queues the requests until a job 
stream becomes available. 


The batch queue is an indexed file containing the file 
descriptors (fds) of the jobs to be processed. Each job is 
identified in the queue by the fd of the command file. The batch 
queue is ordered in priority order and on an “first-in/first—-out 
(FIFO) basis within a priority. 


Tasks executing in the batch environment run at a priority lower 
than or equal to the tasks in the terminal environment. Thus, a 
batch job executes when the system is not occupied with work from 
a terminal user. Batch jobs use the processor's idle time, and 
therefore, increase the efficiency of the system. 


5.2 BATCH COMMANDS 


The batch job file consists of a series of MTM user commands 
and/or command substitution system (CSS) calls. The commands 
presented in this section are unique to the batch environment. 


To submit a batch job, a user must have created a batch job file 
on disk. This file must have a SIGNON command as the first 
record, and a SIGNOFF command as the last record. The only valid 
commands to be used between the SIGNON and SIGNOFF commands are 
MIM user commands (see Chapter 2), program development commands 
(see Chapter 4), batch processing commands and calls to a CSS 
file (see Chapter 6). A batch job file is not a CSS. This 
invalidates CSS commands, with the exception of $IF..., $ELSE and 
$ENDC. Any command that can be used at a terminal can be used in 
the batch job file. 
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Examples: 


The following is an example of a single batch job file: 


CSS 


SIGNON TEST1,1, PWD 
L TEST 1 

st 

SIGNOFF 


can be used to build a batch job file and 


follows: 


SELSE 


xx ASM.CSS [MODULE ] 
xx @ 1 (MODULE TO BE ASSEMBLED) 


x EXAMPLE: ASM EXIN 
x x& 
$BU @1.JOB 
SIGNON @1 
XAL @1.LOG, IN, 80 
LOG @1.LOG,5 
ASM/G @1 
$IFE 0 
MESS LEE *** @1.JOB COMPLETE *** 


MESS LEE *** @1.JOB ERROR *** 
-$ENDC 

SIGNOFF 

$ENDB 

SUB @1.J0B, DEL 


submit a job as 
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{} INQUIRE |} 


5.2.1 INQUIRE Command 
The INQUIRE command queries the status of a job on the _ batch 
queue. 


Format: 


r,£Qy 


INQUIRE el 


Parameters: 


fd identifies the job for which the status is 
desired. If fd is not specified, all jobs 
with account numbers the same as the _ user's 
are displayed. 


fd, specifies the file or device to which the 


display is output. If this parameter is 
omitted, the default is the user console. 


Functional Details: 


When this command is entered by a privileged user, information 
about all jobs on the system is displayed. Standard MTM users 
see just the jobs related to the user's private account. This 


command can be entered in command, task-loaded and task-executing 
modes. 


Possible responses to the INQUIRE command are: 


JOB fd NOT FOUND 
JOB fd EXECUTING 
JOB fad WAITING BEHIND=n 


NO JOBS WITH YOUR ACCOUNT 
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Examples: 
All jobs with the user account number are displayed with the 
following: 

INQ 


The status of TASK.JOB is displayed with the following: 


INQUIRE TASK.JOB 
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5.2.2 LOG Command 


The user can invoke a batch job to produce a log of its commands 
by including the LOG command and the $COPY command within the 
batch stream. 


Format: 


wo toa | tT | [at 
+ [Mier ft Las 


SET Loc [fd] 


Parameters: 


fd is the file descriptor of the log file or 
device. If no fd is specified, logging is 
terminated. If fd is a file, it must be 
previously allocated. Files are assigned 


exclusive write-only (EWO) privileges so that 
logged output is added to the end of the file. 
If a log is active when a second LOG command 
is entered, the old log is closed and the new 
one is initiated. 


NOCOPY specifies that all output, except messages, is 


written to the log device and not the 
terminal. Messages from other users and the 


operator are written to both the terminal and 
the log device. 


COPY specifies that all output is written to both 
the terminal and the log device. 


n is a decimal number from 0O through 65,535 
specifying the number of lines after which the 
log file is to be checkpointed. If this 
parameter is omitted, the default is 15 lines. 
If n is specified as 0, no  checkpointing 
occurs. 
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Functional Details: 


The LOG and the SET LOG commands are the same. The command can 
be entered either way, and both formats perform the same 
function. 


Checkpointing can be done on any type of file. For contiguous 
files, however, the checkpoint operation is treated as a 
no-operation. On nonbuffered indexed and extendable contiguous 
files, the checkpointing is useful only if the file is being 
expanded. On indexed files it is possible that a significant 
amount of time may elapse between the time the data to be written 
to the disk leaves the user's buffer and the time it is 


physically transferred to the disk. In these cases, 
checkpointing flushes the system buffers, as well as updating the 
file size in the directory. In general, checkpointing is 


justifiable only under very specific circumstances, such as when 
a very large amount of data is written to an indexed file over an 
extended period of time, without the file being closed. 


Example: 


LOG PR: 
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5.2.3 PURGE Command 


The PURGE command purges a submitted job from the batch queue. 


Format: 


PURGE fa 


Parameter: 


fd is the file descriptor of the job to be 
purged. Only jobs with the user account 
number can be purged. 
Functional Details: 
If the specified job is executing, it will be cancelled or 


terminated. If the job is waiting to be run, it will be removed 
from the batch queue. 


Example: 


The following will purge TASK.JOB. 


PURGE TASK.JOB 
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| SIGNOFF } 
5.2.4 SIGNOFF Command 


The last command in a batch stream must be the SIGNOFF command. 


Format: 


SIGNOFF 


Functional Details: 


When a batch job user signs off the system, these messages are 
output to the log device or file: 


ELAPSED TIME=hh:mmn:ss , PROCESSOR=hh:mm:ss:mnm TSK-ELAPSED«hh: mm: ss 
SIGNON LEFT=hh:mm:ss PROCESSOR LEFT=#hh:mm:ss 
TIME OFF=mm/dd/yy hh:mm:ss 


The SIGNOFF command can be entered in command, task-loaded and 
task-executing modes. 


If no signon or processor time limits are established in the 
authorized user file (AUF) for the account under which the batch 
job is signed on, the SIGNON LEFT and PROCESSOR LEFT messages are 
not output. 
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| SIGNON | 


5.2.5 SIGNON Command 


SIGNON must be the first command in a batch job. 


Format: 


fa 
SIGNON userid, actno, password |zINrRONENT=| ij 


PROCESSORT IME 
; =maxt ime 
CPUTIME 


[ ;classid=iocount , [,---,elassid=iocount,,} | 


Parameters: 


userid 


actno 


password 


ENV I RONMENT= 
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NULL [: ] 


is a l- to 8-character alphanumeric’ string 
specifying terminal user identification. 


is a 5-digit decimal number specifying the 
terminal user's account number. This must be 
a valid account number in the AUF and can 
never exceed 65,535. If this parameter is 
omitted, the password parameter shouid also be 
omitted. MTM will use the account number of 
the user submitting the batch job. 


is a l- to 1l2-character alphanumeric” string 
specifying the terminal user's password. This 
parameter should be omitted if the actno 
parameter is omitted. MTM will use the 
password of the user submitting the job. 


fd is the file descriptor specifying the file 
that will establish the user's environment at 
signon time. 


NULL specifies that the signon CSS procedure, 
USERINIT.CSS, should be ignored and the user 
will establish the environment at signon time. 
If the entire keyword parameter is omitted, 
MTM searches all on-line disks for the signon 
CSS procedure, USERINIT.CSS/P. The system 
volume (system account) is searched last. 


If USERINIT.CSS is found, MTM calls the CSS 
and executes the routine. If it is not found, 
MTM enters command mode. 


PROCESSORTIME= maxtime is a decimal number specifying the 

CPUTIME= maximum processor time to which the batch job 
is limited. Processor time in a Model 3200MPS 
System is central processing unit and 
auxiliary processing unit (CPU+tAPU) time, 
whereas in a_ uniprocessor system, processor 
time is only CPU time. If this parameter is 
omitted, the default established at system 
generation (sysgen) is used. If 0 is 
specified, no limits are applied. The 
parameter can be specified as: 


mmmm: 8s 
hhhh:mm:ss 
ssss 


classid= is one’ of the 4-character alphanumeric 
mnemonics, specified at sysgen, associated 
with each specified device or file class. 


1ocount is a decimal number specifying the maximum 
number of input /output (1/0) transfers 
associated with the particular device class to 


which the batch job is7 limited. If this 
parameter is omitted, the default established 
at sysgen is used. If O is specified, no 


limits are applied to that class. 


Functional Details: 


Between the SIGNON and SIGNOFF commands, any command or CSS call 
that is valid from the terminal is allowed. A SIGNON command 
cannot be followed by another command on the _ same _ line. When 
ENVIRONMENT=NULL is specified, the colon is optional. This 
allows the user to specify the null device (NULL:). 


The account number and password can be omitted if a batch job is 
submitted from a user terminal. If a batch job is submitted from 
the system console or via the spooler, the account number and 
password must be specified. 


The ENVIRONMENT= parameter is ignored if the user does not have 
the ENVIRONMENT AT SIGNON privilege. 
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Examples: 


SIGNON ME 

S ME,12,PSWD,CPUTIME=2:30:00,DEV1=150 
S ME,CPUTIME=120 

S ME,ENV=NULL, PROCESSORTIME=120 

S) 


ME , ENV=XYZ 
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{| SUBMIT | 


5.2.6 SUBMIT Command 

The terminal user adds a job to the batch queue with the SUBMIT 
command . , 

Format: 


SUBMIT fa [,DELETE] [, PRIORITY=pr ior ity] 


Parameters: 


fd is the file descriptor of the file submitted 
to batch. 
DELETE deletes the batch job file created to submit 


the batch job. If this parameter is omitted, 
the batch job file remains on the user volume. 


- PRIORITY= is a decimal number that specifies the 
priority at which a batch job will run. The 
range of valid priority numbers is dependent 
upon the user's account privileges, sysgen 
options and MTM priority. The maximum range 
allowable is MTM priority + 1 through 255. If 
this parameter is omitted, a batch job will 
run at the default batch priority (the default 
batch priority is 12 lower than MIM priority 
plus the value specified at MTM sysgen time 
for batch priority) or the link priority (the 
priority established when the task was built), 
whichever is lower. 


Functional Details: 


The priority at which a batch job runs is relative to MIM 
priority and the default batch priority established at MTM sysgen 


time. The user task (u-task) priorities are established at Link 
time and can be reset with the PRIORITY parameter of the SUBMIT 
command. Interactive tasks run at a default priority that is 12 


priorities lower than MTM. Batch jobs run at a default priority 
that is 12 lower than MTM plus the value specified at MTM sysgen 
time. If the MTM sysgen priority is set to equal 1 and MIT 
priority equals 128, interactive jobs will run at priority + 12 
(140), or 12 lower than MTM; batch jobs will run at priority + 13 
(141), 13 lower than MTM. 
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The rules for establishing priorities are: 


@e Batch jobs can run at the same priority as interactive tasks, 
but not higher than interactive tasks if the user account has 
this privilege enabled; otherwise, they are run at (maximum) 
one priority lower than interactive tasks. 


e If a valid priority is specified, the batch job runs at that 
priority or the link priority, whichever is lower. 


e If the specified priority is invalid, the default priority is 
assigned by MTM and the following message is displayed: 


WARNING - REQUESTED PRIORITY n ILLEGAL, n USED 


e If the specified priority is greater than 255, 255 is used. 


e If no u-task priority is specified with the SUBMIT command, 
the batch job runs at the default priority or the link 
priority, whichever is lower. 


Tne SUBMIT command can be entered in command, task-loaded and 
task-executing modes. 


Example: 


Create a batch job stream from the terminal via the BUILD...ENDB 
sequence: 


BUILD TEST.JOB 
SIGNON ME,ENV=NULL. 
LOG PR: 

L TEST.TSK 

AS 3,PR: 

START 

SIGNOFF 

ENDB 


Submit the job from the terminal for batch processing: 


SUBMIT TEST.JOB 


Submit a batch job file and have it deleted after the batch job 
execution is complete: 


SUBMIT X¥Z.JOB, DELETE 
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Submit a batch job and have it run at the same priority as an 
interactive job: 


SUBMIT XY¥Z.JOB, P=129 


5.3 BATCH JOB SUBMISSION USING THE SPOOLER 


The spooler is also used to submit batch jobs to the batch queue 
for execution under MTM. Batch jobs submitted through the 
spooler can later be resubmitted as a batch job through the 
terminal. 


5.4 ERROR HANDLING 


Any error that occurs in a batch job file causes automatic 
termination of the job, and a message is written to the log f.ile 
or device. If a batch task pauses, the task is cancelled by MT 
with an end of task code of 255. The job is terminated unless 
the batch task pause option was enabled at MTM sysgen (see 
Section 5.5). When a batch task is completed, the end of task 
code can be tested by subsequent commands in the batch stream to 
determine if the task completed normally. 


5.5 BATCH TASK PAUSE OPTION 


This option allows a batch task to pause without being 
immediately cancelled by MTM. MTM logs the following message to 
the system console if a batch task enters the paused state: 


hh:mm:ss -MTM > taskid BTCH TSK PAUSED 


In this message, taskid is the name of the batch task that has 
paused. The system operator has the option to cancel or continue 
the paused batch task. 


5.6 EFFECT OF RESTRICTED DISKS ON BATCH JOBS 


When accounts with access to restricted disks are given 
read/write access, batch jobs are not affected. If read-only or 
no access is specified, messages are not displayed on the _ user 
console. If a submit file for a batch job is on a restricted 
disk and account O does not have read/write access, the following 
message is displayed on the system console: 


-MTM: BATCH ASGN-ERR TYPE=PRIV JOB=fa 
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CHAPTER 6 
COMMAND SUBSTITUTION SYSTEM (CSS) 


6.1 GENERAL DESCRIPTION 


The CSS is an extension of the OS/32 command language. It allows 
the user to establish files consisting of sequences of commands 
ranging from elementary to extremely complex. It also 
incorporates such features as parameter substitution, variables, 
decision making and branching. 


Once a CSS file has been established, it can be executed by 
entering a single command froma multi-terminal monitor (MTM) 
terminal, or by calling it from another CSS. Parameters can _ be 
passed from one CSS level to the next. 


Through CSS, even the most complex operations can be reduced to 
a simple sequence of commands or even a single command. 


The features available to users via CSS are: 


@e the ability to switch the command input stream to a file or 
device, 


e a set of logical operators to control the precise sequence of 
commands , 


e the ability to pass both positional parameters and keyword 
parameters to a CSS file so that general sequences take on 
specific meaning when the parameters are substituted or the 
keyword encountered in the CSS, 


@e the ability to specify replacement characters within a CSS 
line to alter the function of the line when executed, 


@e the ability to perform decimal and hexadecimal computation and 
conversion within a css line (addition, subtraction, 
multiplication and division), 


@ the ability to use standard local and global variables or new 
global and new internal variables that introduce extended 
power and flexibility to variable usage within a CSS, 


@e the ability to perform searches within specified CSS calls to 
subtract specific sections of the call and use them as 
replacements within the CSS, and 


e the ability for one CSS file to call another, in the manner of 
a subroutine, so complex command sequences can be developed. 
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A CSS file is simply a sequential text file. 
a deck of cards, on a magnetic tape or as 
example of a simple CSS file is: 


*THIS IS AN EXAMPLE OF A CSS FILE 
LOAD TEST.TSK/G,5 

ALLOCATE ANYFILE.EXT,CO,40 

AS 1,OTHRFILE.EXT 

AS 2,ANYFILE.EXT;AS 5, CON: 
ASSIGN 3,PRT:;*LU3-LINEPRINTER 
START 

$EXIT 


NOTE 


It can be stored as 
a disk file. An 


Blank lines are ignored. The semicolon 
allows more than one command to be 
entered on the same line. Null CSS 


commands (;;) are ignored. An 
introduces a comment. 


asterisk 


6.2 ESTABLISHING A COMMAND SUBSTITUTION SYSTEM (CSS) FILE 


Since CSS files differ from other files in content only, they can 
be created just as a source or data file would be; i.e., by using 
the BUILD and ENDB commands or via an editor. 


Both of the following sequences demonstrate the creation of the 
same CSS file: 


nN 


*BUILD DEMO 

B>LOAD ANYTASK, 20 
BOASSIGN 1, INFILE.IN 
B>ASSIGN 2,OUTFILE.OUT 
B>ASSIGN 3,CON: 
B>START 

B>$EXIT 

B>ENDB 

* 


*LO EDIT32 

*ST 

-PERKIN-ELMER OS/32 EDIT 03-145 RO3-O1 
~)> APPEND 

fe ->LOAD ANYTASK, 20 
->ASSIGN 1, INFILE.IN 
->ASSIGN 2,OUTFILE.OUT 
->ASSIGN 3,CON: 
->START 

->$EXIT 

=> 

->SAVE DEMO.CSS 

->END 


i 
WOO BP WON 


~RAY -END OF TASK CODE= OQ PROCESSOR=0.037/0.042 
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The advantage with using an editor is that any mistakes can be 
rectified immediately. Using BUILD and ENDB saves a few steps 
for users not prone to errors, and also supplies the default 
extension of -CSS. BUILD and ENDB are very useful for 
establishing short files. No matter which approach is taken, the 
last command in every CSS file must be the $EXIT command. 


The extension .CSS is not required when a CSS is named. If 
another extension is used, it must be specified when the CSS is 
called. 


6.3 CALLING A COMMAND SUBSTITUTION SYSTEM (CSS) FILE 


A CSS file is called and executed from the terminal by specifying 
the file descriptor (fd) of the CSS file. The demonstration CSS 
established in the previous section would be executed by the 
following entry: 


* DEMO 


If only the filename is specified, MTM assumes the extension .CSS 
and first searches the user default volume in the user's private 
account. If the file is not found, the system account (on the 
system volume) is searched. If the volume name or account class 
is specified by the user, no search of the system account is 
made. If the CSS file resides on a volume other than the user 
default volume (and is not a system CSS) the volume name must be 
supplied. 


For example, if the demonstration CSS was called in either of the 
following manners, MTM would not bother to search the _ system 
files if it could not find the DEMO.CSS file on the user's 
private account: 


*M301:DEMO 
or *DEMO/P 
Specification of a volume name also allows the user to call CSS 
files that belong to the user's’) private account, but do not 
reside on the current default user volume. 
If a CSS file is saved under an fd with an extension other than 
-CSS, the extension must be specified when the CSS is called. 


For example, a CSS file saved as CSSFILE.ANY would be called by 
the following entry: 


*CSSF ILE .ANY 
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A CSS can call another CSS file. The level to which CSS calls 
can be nested is set at MTM system generation (sysgen). If this 
maximum number is exceeded, an error message is displayed and all 
active CSSs are cleared. 


A user must have the CSS privilege in order to call CSS files in 
the user's private account or group. If not privileged, the user 
can only call system CSSs. If the user also has the privilege to 
specify account numbers instead of classes, the user can calla 
CSS in any account. If the leading characters of a CSS fd are 
the same as a command, MTM assumes a command. 


Examples: 
CLO.CSS CLOSE MTM assumes the CLOSE command. 
AS3.CSS ASSIGN 3 MTM assumes the ASSIGN command. 


A CSS file that would otherwise conflict with an MTM command can 
be called by specifying a volume name and/or extension. 


Example: 


M300: CLOSE 
M300:CLOSE.CSS 


6.4 USE OF PARAMETERS 


Parameters can be passed to a CSS when it is called. There are 
two types of parameters available to the user, positional 
parameters and keyword parameters. These parameters will be 


explained later in this section. 


Parameters are entered after the CSS fd and are separated from it 
by one character space. If there is more than one _ parameter, 
each is separated by a comma. If a parameter contains the double 
quote character (") or single quote character ('), all parameters 
up to the next double quote character are passed as one 
parameter. Null parameters are permitted. 


Examples: 
In the following example, the DEMO.CSS file is called. Two 


positional parameters are passed. The first is A, the second is 
B, C: 


DEMO A,"B, C" 
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In this example, three parameters (two positional and one 
keyword) are passed. The first positional parameter is A, the 
second is null. The parameter passed via the Keyword ANYTHING is 
C: 


DEMO2 A, ,ANYTHING=C 


6.4.1 Positional Parameters 


Within a CSS file, a positional parameter is referenced by the 
use of the special symbol "@n" where n is a decimal integer 
number indicating which parameter the user is’7 referencing. 
Parameters are numbered starting with 1. Parameter O has special 
meaning; it refers to the name by which the CSS is called. The 
first parameter is referenced by @1, the second @2, etc. A 
straightforward text substitution is employed. 


Example: 
A CSS file ROG consists of: 


LOAD @1 
START @3,@2 


It is called as follows: 
ROG PROGRAM, NOLIST, 148 


Before each line of the CSS file is decoded, it is preprocessed 
and any reference to a parameter is substituted with the 
corresponding text. Thus, the file ROG with the previous call is 
executed as: 


‘ 


LOAD PROGRAM 
START 148,NOLIST 


@l is replaced with PROGRAM (the lst parameter in the CSS call). 
@3 is replaced with 148 (the 3rd parameter in the CSS call). @2 
is replaced with NOLIST (the 2nd parameter in the CSS call). 


This mechanism allows concatenation. For instance, if the first 
command in file ROG were LOAD @1.TSK, only those files with the 


extension .TSK would be presented to the loader. Concatenation 
of numbers requires care. 123@1 references parameter 1, but 
@1123 is a reference to parameter 1123. A reference to a 


nonexistent parameter is null. 
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All of the following references to parameter 12 are valid 
expressions: 


@12 or @12ABC or @12.EXT 


One CSS file can call another. Within a CSS, the multiple @ 
facility enables a CSS file to access parameters of higher level 
files. CSS files can call each other to a maximum depth 
specified at sysgen time. In a CSS file, @@1 refers to the first 
parameter of the calling file. 


Example: 


Within a file named PROC.CSS there is a call to another CSS file 
named SETUP.CSS. The PROC.CSS file consists of the following: 


PREVENT PROMPT; PRE ETM 
$COPY 

LOAD @1,@2 

SETUP 

START, @3 

$NOCOPY 

ENABLE PR;ENA ETM 

- $EXIT 


SETUP.CSS contains: 


XAL @@1.OUT,IN,132 
AS 6,@@1.IN 

AS 7,@@1.OUT 

SEXIT 


The call to PROC.CSS shown below would produce the subsequent 
display at the user's terminal. 


*PROC ANYTASK,20,"COM=CON: ,LIST=PR:" 
-LOAD ANYTASK, 20 

SETUP 

XAL ANYTASK.OUT, IN, 132 

AS 6,ANYTASK.IN 

AS 7,ANYTASK.OUT 

SEXIT 

START, COM=CON: ,LIST=PR: 

$NOCOPY 
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There can be as many @ symbols used to reference higher level 
CSSs as there are allowable CSS levels. If the SETUP.CSS file 
from the previous example contained a call to another CSS file, 
the CSS called by SETUP.CSS could refer to the parameters passed 
to the PROC.CSS file as @@@1l, @@@2 and @eR3. 


If a multiple @ sequence is such that the calling level referred 
to is nonexistent, the parameter is null. 


Parameter @0 is a special parameter used to reference the name of 
the CSS file in which it is contained. Parameter @0 is replaced 
during the preprocessing of the command line with precisely the 
same fd used to call the file. 

Example: 

A CSS file consists of the following commands: 


AS 1,@0: 
$EXIT 


If this file is called with the filename CR, logical unit 1 (1ul) 
is assigned to the card reader (CR:). The executed form of the 
ASSIGN command becomes: 


AS 1,CR: 
If this file were called with the filename MAG1, the result is: 
AS 1,MAGL: 


It should be remembered that a CSS file is called by (as a 
minimum) the filename portion of the fd under which it is stored; 
no flexibility for calling statements should be inferred from the 
example above. 


To further illustrate the use of the @0 parameter, the PROC.CSS 


file from previous examples could easily be expanded to contain 
the following: 


XAL @0.LOG,IN 
LOG @0.LOG,NOCOPY 


LOG CON: 
SEXIT 
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6.4.2 Keyword Parameters 


The CSS language also provides a means of passing parameters via 
keywords in a CSS call. A straightforward substitution procedure 
is applied. Keywords enable the user to specify a value that is 
subsequently substituted for each reference to the keyword 
encountered within the CSS. The value of a keyword is defined in 
the CSS call in the following format. 


Format: 
keyword = [parameter] 
Parameters: 
keyword is the 1l- to 8-character name of a _ keyword. 
The characters must be alphabetic. 
= is a required delimiter between a keyword and 
its assigned value for the CSS call. This 
delimiter must immediately follow the keyword 
(no blanks allowed). 

. parameter is a character string which replaces’ the 
keyword reference with the css. Null 
parameters are allowed. 

Functional Details: 
The following rules apply for the use of keywords within a CSS 


file and the relationships between keywords and positional 
parameters. 


e The leading blanks of a keyword parameter are skipped unless 
they are included with the parameter through the use of single 


('...') or double ("...") quotes. 

@ All characters between single or double quotes belong to the 
same parameter. This allows the user to define a parameter 
with leading blanks, semicolons, commas or an equal sign. A 


carriage return (CR) is not allowed within the parameter 
Gefinition. 


e An equal sign (=) (by default) marks the keyword. This equal 
sign can be altered (via the SET KEYOPERATOR command) to one 
of six other characters. If a user wishes to define a 
parameter with an equal sign in it, the equal sign must be 
delimited by single or double quotes or the key operator must 
be changed to a character other than the equal sign. 


6-8 48-043 FOO RO2 


@e A keyword must never be followed by a positional parameter. 
All positional parameters must be passed prior to any 
keywords. Positional parameters and keywords must be 
separated by commas. 


Examples: 
These are valid examples of CSS calls using positional parameters 


and keywords: 


TEST ABC.FTN, ,BA,OP=BATCH,LI=CON: 
TEST SOURCE=ABC.FTN,LI=CON: 


These are examples of illegal CSS calls using positional 
parameters and keywords: 


ILLEGAL CSS CALLS REASON 


TEST A,B,FTNOPTION=HOLL Keyword is greater than 8 characters. 


TEST A,B,OP=HOLL,D Positional parameter D is after a 
keyword. 

TEST B, ,OP=LNCT=60 Double equal signs are not valid. 

TEST B, ,=HOLL Keyword name is missing. 

TEST A'='B,C'=D Second quote is not matched. 


Within a CSS file, a Keyword parameter is referred to by the’ use 
of the @= symbol (similar to the @ symbol usage for positional 
parameters). As with positional parameters, multiple @ symbols 
can be used to refer to the keyword parameters of higher level 
CSS files. 


Format: 


[e [e... e]] @=/ [keyword] / 


Parameters: 


@= is the symbol that notifies the preprocessor 
that a reference to a Keyword parameter is 
being made. The use of additional @ symbols 
is allowed to access keywords of a higher 
level CSS. 
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keyword is a l1- to 8-character keyword (excluding 
period). Tne user has the option to define a 
minimum set of required characters for a 
keyword. This is accomplished by separating 
the required characters and the optional 
characters with a period. Required characters 
precede the period; optional characters follow 
the period. 


For example, defining a keyword in the 
following manner: 


@=/OP.TION/ 


indicates that the keyword is OPTION and the 
minumum required character set to reference 
OPTION is OP. 


Functional Details: 


If the same keyword mnemonic is passed more than once in a CSS 
call, the first keyword match found is used in substitution 
(scanning from left to right in the call). 


References to nonexisting keywords or to higher CSS levels which 
do not exist are not expanded. The same applies to references 
without a keyword. References with a keyword expand in the usual 
manner. The following examples show the result of using keyword 
references in a CSS file and then passing keyword parameters in 
the CSS call. An equal sign (=) can be passed as part of the 
keyword value as_ long as it is bracketed with single or double 
quotes. Single quotes can be passed as part of the keyword value 
as long as they are bracketed by double quotes. Similarly, 
double quotes can be passed as long as they are enclosed within 
single quotes. 


Examples: 


The following listing presents an example CSS that uses keywords: 


XAL @=/0.UTPUT/,IN,66 
XAL @=/W.ORK/,IN,66 

LO SRTMRGII,50 

AS 1,@=/1.NPUT/ 

AS 2,@=/0.UTPUT/ 

AS 4,@=/W.ORK/ 

AS 5,CON: 

AS 9,MTM:SRTMRGII.OVY/S 
START 

$EXIT 
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The CSS listed above can be executed by any of the three calls 
listed below (provided the CSS had been saved as SORT.CSS): 


SORT INPUT=DEMO. IN, OUTPUT=DEMO. OUT ,WORK=DEMO .WRK 
SORT IN=DEMO. IN, OUT=DEMO.OUT , WO=DEMO .WRK 


SORT W=DEMO.WRK,0O=DEMO.OUT, I=DEMO.IN 
The executed form of the CSS would be the listing below. 


XAL DEMO.OUT, IN,66 

XAL DEMO .WRK, IN, 66 

LO SRTMRGII,50 

AS 1,DEMO.IN 

AS 2,DEMO.OUT 

AS 4,DEMO.WRK 

AS 5,CON: 

AS 9,MTM:SRTMRGII.OVY/S 
START 

SEXIT 


6.5 USE OF VARIABLES 

MTM and batch users can allocate a predetermined number of 
variables to be used within a CSS. The maximum number of 
variables that can be allocated by a user is set at MTM_ sysgen. 
In general there are two types of variables: those that exist 
from signon to signoff, and those that only exist while the 
Gefining CSS is active. There are now further distinctions 
between the types of variables available with MTM. 

6.5.1 Types of Variables 


There are four types of variables available to MIM users: 


e global variables, 
@e local variables, 
@e new global variables, and 


@ new internal variables. 
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The first two types, global and local variables, should be 
familiar to all users of releases of MIM prior to RO6.2. Global 
variables exist from signon to signoff or until they are freed 
via the §$FREE command. Local variables can only be used while 
the CSS in which they are defined is active. When a particular 
CSS level is exited, all local variables defined within it are 
freed. 


The maximum number of global and local variables that can be 
defined is established at MIM sysgen time. See the 0S/32 
Multi-Terminal Monitor (MTM) System Planning and Operator 
Reference Manual. 


The third and fourth variable types, new global and new internal, 
are similar to the local and global variables in terms of usage. 
The way in which they are defined and released and the 
capabilities available when defining these variables make them 
much more powerful and flexible than the previous variables. 


New global variables exist from signon through signoff, until 
they are released via the $RELEASE command, or until assigned an 
undefined value by the $DEFINE command. The number of new global 
variables allowed in a system is determined at MTM-  sysgen 
(maximum of 99). No new global variables are allowed in the 
system if the new global option is disabled at MTM sysgen. 


New internal variables exist only while the CSS in which they are 
defined is active. New internal variables are released on 
termination of the defining CSS. The user can release new 
internal variables via the §$RELEASE command or by using an 
undefined value via a $DEFINE command. The maximum number of new 
internal variables that can be used is set at MTM sysgen time 
(maximum of 99). 


NOTE 


Users should be familiar with the use of 
both new global and new internal 
variables. These variable types will 
eventually replace the local or _ global 
variables usage. 


6.5.2 Naming Local or Global Variables 
A local or global variable name can consist of l- to 8-characters 
and must be preceded by the commercial @ sign. The character 


following the @ sign must be alphabetic; the remaining characters 
can be alphanumeric. 
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Examples: 


@LKL1 
@GLBL5 


@ANYTH ING 


Local variables are named via the $LOCAL command. Global 
variables are named via the $GLOBAL command. Values can be 
assigned to predefined local and global variables via the $SET 
command. These commands’) are discussed in detail later in this 
chapter. Their basic use is shown in the following example: 


$LOCAL @SEGSIZE;$GLOBAL @PRINTDEV 
$SET @SEGSIZE=@3;$SET @PRINTDEV=@4 
LOAD SOMETASK, @SEGSIZE 

OTHERCSS 

$EXIT 


Once a global variable has been defined, it can be referred to by 
any CSS file called between the time it is defined and the time 
the user signs off or frees the variable. A local variable can 
only be referred to within the CSS in which it is defined. To 
illustrate, the CSS file named OTHERCSS called in the example 
above could refer to the global variable @PRINTDEV. OTHERCSS 
could not, however, refer to the local variable @SEGSIZE unless 
it was specifically defined within OTHERCSS. 


6.5.3 Naming New Global or New Internal Variables 
A new global or new internal variable name can consist of 1- to 
8-characters. The first character must be alphabetic; the 
remaining characters alphanumeric. 
Examples: 

INTRNL1 

GLBL12 

WHATEVER 
New global and new internal variables are named via the $DEFINE 
command and, at that time, are associated with a decimal number. 
The number associated with the variable is for reference 
purposes; it has nothing to do with the value of the variable. 


Because new global and internal variables are associated with 
numbers, the use of names is optional. 
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The $DEFINE command provides the user with many options for 
establishing and assigning values to new global and new internal 
variables. 


$DEFINE is an extremely flexible and useful command; the 
following examples represent only basic implementations. 


The following example establishes a new global variable. The 
decimal reference number associated with the variable is 7, its 
name is GSYSVOL and the value assigned to it is the name of the 
default system volume. 


$DEFINE GVARIABLE 1, GSYSVOL, DVOLUMENAME (SYSTEM) 


The following example establishes new global variable number 2. 
This variable is not given a name; it is assigned the value of 
the userid under which the terminal user or batch job is signed 
on. 


$DEF G 2,,CURRENT (USERNAME) 


The following example establishes new internal variable number 7, 
gives it the name LSTDEV and assigns it the string value CON: 


$DEF IVAR 7,LSTDEV, STRING (CON: ) 


In this example, a new internal variable is established (by 
default) and associated with the number two. It is given no 
name, and is identified as a required variable. 


$DEFINE 2, ,REQUIRED 


Once defined, the variable can be referred to by name or number 
within a CSS. The following conventions apply to the expansion 
of a new global or new internal variable within a CSS. 


e To reference the value of a new global or new internal 
variable, the following format can be used. 


Format: 
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Where: 


name 


e To obtain the name of 


Format: 


Where: 


hy 


Examples: 


specifies a reference to a new global 
variable. 


specifies a reference to a new internal 
variable. This is the default. 


specifies the number of the variable to 
be referenced. 


specifies the name of the variable. 


a new variable use the following format. 


specifies a new global variable. 
specifies a new internal variable. 


specifies the number of the variable 
whose name is being requested. 


The following example references global variable number 3. 


@*G3 


The following example 
VOLUME . 


@* /VOLUME / 
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references the internal variable name 


The following example references the name of internal variable 
number 3. 


@*N3 


6.5.4 Command Substitution System (CSS) Line Expansion 


The MTM preprocessor expands the entire CSS line in one. step. 
Because of this, the user is advised to be careful when using the 
new global or new internal variable name/value in the CSS line 
after redefining them with a $DEFINE command. 


The following illustrates how the preprocessor handles’ these 
occurrences: 


$DEF INE1, ,ST(ORIGINAL) 
$DEFINE1, ,ST(NEW) ; $DEF INE3, ,ST(@*1) 


This expands to: 
$DEF INE1, ,ST(NEW) ; $DEF INE3, ,ST(ORIGINAL) 


The value of the new internal variable 3 is not the expected 
string NEW, but the string ORIGINAL.» 


6.5.5 Reserved Variables 


Variable names starting with the character string @SYS are 
reserved for system use. A user cannot define variables starting 
with @SYS. However, a user does have read and write access to 
@SYS variables. 


The global variable @SYSCODE is reserved and contains the value 
of the last end of task code for a particular session. 


6.6 COMMANDS EXECUTABLE WITHIN A COMMAND SUBSTITUTION SYSTEM 
(CSS) FILE 


All of the MTM supported commands can be used in a CSS file (see 
Chapter 2), as well as a number of commands” specifically 
associated with the CSS Facility. Several of these commands’) can 
also be used in the command mode. For example, new global 
variables can be established via the $DEFINE command. The $COPY 
and $NOCOPY commands can also be used in command mode. 


Most of the CSS commands start with the §$ character with the 
exception of the SET CODE and PRIOR commands. 
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The CSS commands entered within a CSS file are described in the 
See Appendix E for CSS message descriptions. 


following sections. 
NOTE 

If a task is started when CSS is running, 

CSS becomes dormant until the task is 


terminated. Execution of the CSS stream 
will resume after the task terminates. 
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6.6.1 Character Replacement Command (%...%) 


The character replacement command (%...%) enables a user to 
define and replace up to four different characters within a 
specified CSS line. The user must indicate the line in which 
replacement is to occur, the new characters and the characters to 
be replaced. Unless otherwise specified, every occurrence of a 
specified character within the line will be replaced. 


Format: 


Si Aaa 
% 


% new delimiter 


Parameters: 

% is the initial current replacement string 
Gelimiter. This indicates the start of the 
character replacement specification. 

char lchar2, is the specification of the character to 


...charlchar2, be replaced (charl) and the character to be 
used as the replacement (char2). Up to four 
of these replacement specifications can be 
specified. The preprocessor translates this 
statement as: replace the character specified 
by charl with the character specified by 
char2. If more than one replacement 
specification is present there must be no 
blanks between them. If charl and char2 are 
the same, charl is deleted from the CSS line. 


% new this indicates that a new replacement 

delimiter delimiter (by default the % sign) follows. 
The new delimiter is the first character after 
the % sign and is active for the remainder of 
the CSS line (or until a new delimiter is 
specified). 
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Functional Details: 


Character replacement operations are only performed in lines that 
have a percent sign (%) in column 1 of the _ line. This percent 
sign (%) is not’ part of the character replacement command, it 
merely flags lines eligible for character replacement. 


Character replacement is only allowed within a CSS. 


The only legal use of blanks within the character replacement 
delimiters is as replacement characters. The initial replacement 
delimiter is always reset to % at the beginning of each CSS line 
and previous replacement characters are deleted. In effect, each 
CSS line with replacement information is treated as a single 
entity. 


Each usage of the character replacement command resets all 


previously defined replacement characters. When a new 
replacement delimiter is specified, all other replacement strings 
are cleared. The $COPY command suppresses the display or 


printing of replacement string delimiters and replacement 
strings. 


NOTE 


Replacing a character with an @ symbol 
will result in an additional 
preprocessing step for that line in order 
to expand the é symbol with the - 
appropriate substitution parameter if 
possible. 


The examples in Table 6-1 are used to illustrate the basic 
functionality of the character replacement command. The uses of 
this command are not limited to those shown in the _ table. The 
command becomes extremely powerful as the user introduces more 
involved substitution and replacement within the same line. 
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TABLE 6-1 EXAMPLES USING THE CHARACTER REPLACEMENT COMMAND 


— ee et a a Ve a oe a Oe ee a ee ee ee eee ee ee ee ee ee ee ee ee ee oe ee eee ee cee meee eee eee eee ees ised ere wily mee Gees cme Was Wate ites ‘iene tite Gadel tdi 


CHARACTER REPLACEMENT i H RESULT AFTER 
{ ' 


CSS LINE H INTERPRETATION i PROCESS ING 
sc S SSS SS SV SSS SSS SSS SAS SS SC SC SEES SSE SS SESS SSS SS SE SE SS SE OE SS Ss se a ee 
%LO %$',%F7D'20 i Replace the single | >LO F7D,20 


1 5 
{ quote character (') H 
| with the comma (,) in } 
i the string F7D'20. { 

&LO $%\\',\F7D'20 {| Change the replace- i SLO F7D,20 

i} ment delimiter from H 

| $ to the \, and | 

| replace the single 

} quote character with | 

; the comma in the 

} String F7D'20. 

%LO F7D%‘' ,A2B0%'AB | Replace the single {| >LO F7D,20 
} quote character with | 
} a comma, replace A H 
| with 2, replace B 
{| with a O in the char- | 
ij acter string ‘AB. The | 
| string F7D remains 
{ unchanged. 

$LO %',%F7D'20;%%%$W'A', | Replace the single | >LO F7D, 20; gw AS 

{ quote character with | 

;} the comma character 

} in the string F7D'20. | 

i Then reset the line 

| (clear all replace- | 

i ment instructions for | 

; the balance of the H 

} line). Because of { 

| this, the single 1 

} quotes around A are H 

i not replaced. 


on mt ce OD ee ee oe eS ee ee ee ee ee ee ee ee ee ee Se Se eS ee eee oe ee ele Gi ee eee cme cee seme cme mind nt coe tem meter pe ce ulin ore Weeks me (mits tie OD iin ce i mY ee unt oe 


Another use of the character replacement command is the 
combination of character replacement and parameter substitution. 
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Example: 


This example will result in three preprocessing passes’ through 
the line in order to complete the requested functions. A step by 
step analysis will show this. 


$BUILD TEST 


SSE\\*O\SE+ESSWR @1 
$EX 
$ENDB 


Assume TEST CSS is called with the following call: 
TEST *2,+3,'3RD USED' 


The first preprocessing pass through the line causes the command 
delimiter to be changed from %§ to \, the first parameter in the 
CSS call (*2) replaces the @1 reference in the CSS, and the * is 
replaced with an @ symbol. The line now looks like this: 


%%+@3SWR @2 


Replacing an @ sign requires a second preprocessor pass_ through 
the line in order to expand the _ reference. On the second 
preprocessing pass through the line, the second parameter in the 
CSS call (+3) replaces the @2 reference in the CSS line, and the 
+ is replaced by an @ symbol, according to the second character 
replacement specification. The line now looks like this: 


$WR @3 


Replacing an @ sign reference requires a third preprocessor pass 
through the line in order to expand the parameter reference. On 
this pass the third parameter in the CSS call (3RD USED) is 
substituted for the @3 reference within the CSS. The line now 
looks like this: 


$WR 3RD USED 


No further preprocessing of the line is required. The final 
output of this CSS when called as detailed previously would be: 


-3RD USED 
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$ENDB ' 


6.6.2 $BUILD and $ENDB Commands 


The $BUILD command causes succeeding lines to be copied to a 


specified file up 


to, but excluding, the corresponding $ENDB 


command. Before each line is copied, parameter substitution is 


performed. 
Format: 
fa)[,APPEND | 
SBUILD 
lu 
$ENDB 
Parameters: 
fd is the output file. If fd does not exist, an 
indexed file is allocated with a logical 
record length equal to the command buffer 
length. If the fd specified does not contain 
an extension, .CSS is the default. If a blank 
extension is desired, the period following the 
filename must be specified. 
lu specifies that a temporary file is to be 
created and the $BUILD data is copied to it. 
When $ENDB is encountered, the file is 
assigned to the specified logical unit of the 
loaded task. The lu option is valid only when 
a task is loaded. 
APPEND allows the user to add data to an existing fd. 


Functional Details: 


The $BUILD command 


If the fd does not exist, it is allocated. 


must be the last command on its’ input line. 


Any further information on the line is treated as a comment and 
is not copied to the file. 
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The $ENDB command must be the first command in the command line, 
but it need not start in colum 1. Other commands can follow 
$ENDB on the command line, but nesting of $BUILD and $ENDB is not 
permitted. 


Examples: 


The example CSS from section 6.4.1 can be altered to illustrate 
the use of the $BUILD and $ENDB commands: 


$BUILD SORT. CMD 
KEY @=/K.EYS/ 
SORT @=/I.NPUT/ > SORT.OUT 
END 
$ENDB 
XAL SORT.OUT, IN, 66 
LO SRTMRGII,20 
AS 1,@=/I.NPUT/ 
AS 2,SORT.OUT 
AS 3,CON: 
TEMP 4,1N,5/3 
AS 5,SORT.CMD 
AS 9,MTM:SRTMRGII.OVY/S 
ST 
DEL SORT. CMD 
$EXIT 


The following version of the example CSS demonstrates the use of 
the lu parameter of the $BUILD command. 


XAL, SORT.OUT, IN, 66 
LO SRTMRGII,20 
AS 1,@=/I.NPUT/ 
AS 2,SORT.OUT 
AS 3,CON: 
TEMP 4,IN,5/3 
SBUILD 5 
KEY @=/K.EYS/ 
SORT @=/I1.NPUT/ >SORT.OUT 
END 
$ENDB 
AS 9,MTM:SRTMRGII.OVY/S 
ST 
$EXIT 
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6.6.3 $CLEAR Command 


The $CLEAR command terminates a CSS stream, closes all CSS files 
and deactivates CSS. 
Format: 
SCLEAR 
Functional Detail: 


The $CLEAR command can be entered in command, task-loaded and 
task-executing modes. 
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6.6.4 $CONTINUE Command 
The $CONTINUE command resumes’ execution of 
suspended by a $PAUSE or $WAIT command. 


Format: 


SCONTINUE 
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a CSS procedure 


{ §$COPY AND i 
$NOCOPY | 


6.6.5 $COPY and $NOCOPY Commands 

The $COPY and $NOCOPY commands control the listing of CSS 
commands on the terminal or log device (if from batch). §COPY 
initiates the listing. All subsequent commands are copied to the 
terminal before being executed. The $NOCOPY command deactivates 


the listing, but is itself listed. The $CUOPY command is an aid 
in debugging CSS job streams. 


Format: 


SCOPY 
SNOCOPY 
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6.6.6 $DEFINE Command 


The $DEFINE command is used to define or to redefine new global 
or new internal variables. 


Format: 


GVARIABLE 


7 tn , [name] , operator, (operator... -operatory] 


Parameters: 


GVARIABLE 


IVARIABLE 


name 


operator, 
operator,. 
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specifies that a new global variable is being 
defined. (not. allowed if new global option is 
set off at MTM sysgen). 


specifies that a new internal variable is 
being defined. This is the default. 


is the new variable number. The allowed range 
is between 1 and the maximum value set at MTM 
sysgen. 


is the new global variable or new internal 
variable name. It is one to eight characters 
long and can consist of any character A 
through Z or any number O through 9. 


..operatorn 


is one or more of the following operators, 
which select a particular function to be 
performed to determine the variable's value. 
fd operators: 

e ACCOUNT 

@ FILENAME 

@ EXTENSION 


e@ VOLUMENAME 


Logical operators: 
@® LOGICAL GO 
e LOGICAL LD 
e LOGICAL LU 
e LOGICAL TD 


e LOGICAL TU 


Computation and conversion operators: 
e@ DCOMPUTE 

@e DHCONVERT 

e@e HCOMPUTE 


@ HDCONVERT 


Other operators: 

e CLEAR > 

e CURRENT 

e DVOLUMENAME 

e REQUIRED 

@e SEARCH 

@ STRING 
Tne following sections define the format and function of each 
these operators within the §$DEFINE command. 
6.6.6.1 File Descriptor (fa) Operators 
The following four operators can be used to determine 
account, filename, extension or volume name of a specified fd 
assign the determined portion of the fdas the value of 
variable being defined. 
6.6.6.1.1 ACCOUNT Operator 
The ACCOUNT operator of the $DEFINE command enables a user 


determine the account designator of a specified fd and assign 
designator as the value of the variable being defined. 
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of 


the 
and 
the 


to 
the 


RO2 


Format: 


fda 
ACCOUNT 


Parameters: 


fda is the file descriptor of the file or device 
for which the account designator is to be 
assigned as the value of the variable. 


= specifies that the current total result for 
this $DEFINE command is used to determine the 
account designator. 
Functional Details: 
The value returned is /P, /G or /S depending upon the specified 
account. If no account is specified, /P is returned for 
filenames and undefined is returned for devices. If the user has 
the account number privilege, the account number, rather than an 
account class, is returned. 
Examples: 
The following CSS is built: 
$BUILD TEST 
$DEFINE 6,,ACCOUNT (@1) 
$WR @*6 


$EX 
$ENDB 


The above CSS is called with the following call: 
TEST ABC.FTN/G 
The result of the $WR @*6 command is: 


/G 
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6.6.6.1.2 EXTENSION Operator 
The EXTENSION operator of the $DEFINE command enables the user to 


assign the extension of a given fd as the value of the variable 
being defined. 


Format: 


fd 
EXTENS ION 


= 
= 


Parameters: 


fd is the file descriptor of the file or device 
for which the extension is to be assigned as 
the value of the variable. 
= the current total result for this $DEFINE 
command is used to determine the extension. 
Functional Detail: 
The returned value will contain a leading period if an extension 
was specified; otherwise, the value of the variable is undefined. 
Example: 
The following CSS is built: 
BUILD TEST 
$DEFINE 10, ,EXTENSION(@1) 
$WR @*10 


$EX 
ENDB 


When called with the following CSS call: 
TEST FORTRAN .FTN 


the $WR @*10 command would output .FTN. 
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6.6.6.1.3 FILENAME Operator 


The FILENAME operator of the $DEFINE command enables the user. to 
assign the filename of a given fd as the value of the defined 


variable. 
Format: 
fa} 
FILENAME f 


Parameters: 


fd is the file descriptor or device for which the 
filename is to be assigned as the value of the 


variable. 


= the current total 


result for this $DEFINE 


command is used to determine the filename. 


Functional Details: 


If an fad was specified in the FILENAME 
value is the filename. 


If a device name was specified in the 
returned value is undefined. 


Examples: 


The following CSS is built: 


BUILD TEST 

$DEFINE 10, ,F [LENAME(@1) 
$WR @*10 

$EXIT 

ENDB 


When called with the following CSS call: 


TEST M301: TCHFIN12.FTN 


the $WR @*10 result is TCHFIN12. 
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operator, the returned 


FILENAME operator, the 


The FILENAME operator of the $DEFINE command of the CSS is used 
in the following example: 


$DEF 1,,F(@=/1I.NPUT/) 
XAL @*1.OUT,IN,66; XAL @*1.LST,IN,65 
LO SRTMRGII,20 
AS 1,@=/1.NPUT/ 
AS 2,@*1.OUT 
AS 3,@*1.LST 
TE 4,1N,5/3 
5 


KEY @=/K.EYS/ 
SORT @=/I.NPUT/ > @*1.OUT 
END 

$ENDB 

AS 9,MTM:SRTMRGII.OVY/S 

ST 

S$EXIT 


6.6.6.1.4 VOLUMENAME Operator 
The VOLUMENAME operator of the $DEFINE command enables the user 


to assign the volume name of a given fd to the variable being 
def ined. 


Format: 


Parameters: 


td is a file descriptor of the file for which the 
volume name is to be assigned as the value of 
the variable. 


= the current total result for this §$DEFINE is 
used to determine the volume name. 
Functional Details: 
The new variable value returned is the specified volume name, or 


the user's private volume name under MTM. The volume name is 
always followed by a colon (:). 
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Example: 


The following CSS is built: 


BUILD TEST.CSS 

$DEFINE 20,, VOLUMENAME (M301:SOURCE.FTN) 
$WR @*20 

SEX 

ENDB 


Calling the above CSS with the following call: 
*TEST 
the output from $WR @ *20 is -M301:. H 
6.6.6.2 LOGICAL Operators 
The LOGICAL operators of the $DEFINE command enable the user to 


test the current or last result as defined, exit from the $DEFINE 
command or skip operators within the §$DEFINE command. 


Format: 


os 
+L Lema 
ta tana 


Parameters: 


GO specifies an unconditional skip of operators 
or an exit from within the $DEFINE command. 


n is a decimal number between O and 999. 
e O indicates exit the $DEFINE command. 


e 1-999 indicates’ skip this number of 
operators. 
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L specifies that the result of the last operator 
is to be tested. The test performed depends 
upon whether the D or U option follows. 


T the current total result of the $DEF INE 
command is tested. The test performed depends 
upon whether the D or U option follows. 


D tests to see if the result specified by the L 
or T parameters is defined. 

U tests to see if the result specified by the L 
or T parameters is undefined. 

$name is a name defined via the $LABEL command. If 
a skip is specified, the skip will be done to 
this label. 

Example: 


This $DEFINE command perfoms a check to see if the first 
positional parameter in the CSS call contains a filename 
extension. If it does,: the following two operations are 
performed to clear the result of the EXT operator and the $DEFINE 
is exited. : 


- BUILD TEST.CSS 
$DEFINE 5,, ST (@1) EXT (=) LU2 CL(L) GOO ST(.FTN) 


If no filename extension is specified, the following two 
operators are skipped and an extension is attached. 


6.6.6.3 Computation and Conversion Operators 

The computation and conversion operators are used to perform 
decimal or hexadecimal computation and decimal to hexadecimal (or 
vice-versa) conversion, and then assign the result as the value 
of the variable specified in the $DEFINE command. 

6.6.6.3.1 DCOMPUTE Operator 

The DCOMPUTE operator of the $DEFINE command is used to perform 


decimal computation within a CSS line. The computed value then 
becomes the value of the variable defined in the $DEFINE command. 
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Format: 


#digits 
sconeore (| | peeranao[ [operator operanes] [speratorn operand] 


Parameters: 


#digits specifies the number of digits for the decimal 
result with leading zeros and including the 
sign column (+ or -). If not specified, the 
default number of digits used (including sign) 
is 4. 

operand is the operand (in decimal) with optional sign 
(+ or -). The range is absolute up to 
Y'OFFFFFFF'. 

operator is the computational operator: 

+ = addition 

- = subtraction 

* = multiplication 
/ = division 


Functional Details: 
The maximum value allowed for an operand or a result is absolute 


Y'OFFFFFFF'. Values outside this range generate the following 
message: 


DEF 6-ERR 


Mathematical computation is performed from left to right and the 
intermediate result is combined with the next operator and the 
following operand. Computation is performed according to the 
fixed point integer rules of rounding. 

Examples: 

-033 becomes the value of variable 7 (referenced as @*7). The 
default number of digits (4) is used. 


$DEFINE 7,,DCOMPUTE (-33) 
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we we we ww ow 


-00004 becomes the value of variable 4 (referenced as @*4). The 
number of digits in the result is defined as 6. 


$DEFINE 4,,DCOMPUTE (6,-2+5/-2*4) 


+232 becomes the value of variable 5 (referenced as @*5). This 
is determined by multiplying the value of variable 4 (referenced 
as @*4), which is defined above as -4 with the value of variable 
7 (referenced as @*7), which is defined above as -33, then adding 
100 to the result. The default number of digits (4) is used. 


$DEFINE 5, ,DC(@*4*@*7+100) 


6.6.6.3.2 DHCONVERT Operator 


The DHCONVERT operator of the $DEFINE command is used to perform 
decimal computation and then convert the result to hexadecimal. 
This hexadecimal result is then assigned as the value of the 
variable specified in the $DEFINE command. 


Format: 


#digits 
DHCONVERT| |< > ,|operandy| [operator, operand, ] [operatory operandg] | 


Parameters: 


#digits specifies the number of digits for the 
hexadecimal result with leading zeros’ and 
excluding the sign designator. If not 


specified, the default number of digits is 4. 


operand is the operand (in decimal). Negative numbers 
are not allowed. Absolute Y'OFFFFFFF' is the 
maximum value allowed. 


operator is the computational operator: 
+ = addition 
- = subtraction 
* = multiplication 
/ = division 
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Functional Details: 


The maximum value allowed for an operand or a result is absolute 
Y'OFFFFFFF'. Values outside this maximum generate the following 
message: 


DEF 7-ERR 


Mathematical computation is performed from left to right and the 
immediate result is combined with the next operator and the 
following operand. Computation is performed according to _ the 
fixed point integer rules of rounding. 


Examples: 


In the following example, the value of variable 7 (@*7) becomes 
hexadecimal 0021. 


$DEFINE 7, ,DHCONVERT (-33) 


In the following example, the value of variable 4 (@*4) becomes 
a hexadecimal 000004. 


$DEFINE 4,,DHCONVERT (6,-2+5/-2*-4) 


In the following example, the value of variable 5 becomes a 
hexadecimal OOB8. (4x21)+100 = 184 = OOB8 in hex. 


$DEFINE 5,,DHCONVERT (4*@+7+100) 


6.6.6.3.3 HCOMPUTE Operator 


The HCOMPUTE operator of the $DEFINE command enables a user to 
perform hexadecimal computation within the $DEFINE command and 
return the result as the defined variables value. 


Format: 


#digits 
nconeore (| ee | overande[ fooerator, operanai Coverstornoperandil] 
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Parameters: 


#digits defines the number of digits for the 
hexadecimal result with leading zeros. If not 
specified, the default number of digits is 4. 


operand is an operand in hexadecimal without sign (all 
values are assumed positive), the maximum 
value being absolute up to Y'OFFFFFFF'. 


operator is one of the following mathematical 
operators: 


+ = addition 

-~ = subtraction 

* = multiplication 
/ = division 


Functional Details: 
The range allowed for an operand or a result is up to absolute 
Y‘'OFFFFFFF'. Otherwise, the following message is generated: 


- DEF6-ERR 


If the hexadecimal result is negative, the following message _ is 
generated: 


DEF 7-ERR 


Computation within an HCOMPUTE operator is from left to right; 
the intermediate result is combined with the next operator and 
the following operand. 


Examples: 
$DEFINE 7, ,HCOMPUTE (AEO) @*7 = OAEO 
$DEFINE 4, ,HCOMPUTE(6,CO/20+18) @*4 = OOOO1E 


6.6.6.3.4 HDCONVERT Operator 


The HDCONVERT operator of the $DEFINE command enables the user to 
perform hexadecimal computation within a §$DEFINE command. The 
result is converted to decimal and is returned as the value of 
the defined variable. 
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Format: 


#digits 
HDCONVERT [ aera [ operator, operand,] [operator, operand,] | 
4 
Parameters: 

#digits specifies the number of digits for the decimal 
result with leading zeros and the sign (+ or 
=) If not specified, the default number of 
digits is 4. 

operand is a hexadecimal operand without’ sign. The 
maximum value allowed is absolute Y'OFFFFFFF'. 

operator is one of the following mathematical 
operators: 

+ = addition 

- = gubtraction 

* = multiplication 
/ = Givision 


Functional Details: 
The maximum allowable value for an operand or a result is 


absolute Y'OFFFFFFF'. Values greater than the maximum will 
generate the following message: 


DEF 6-ERR 


A negative hexadecimal operand will generate the following 
message: 


DEF 7-ERR 


Computation within the HDCONVERT operator is from left to right, 
and the intermediate result is always combined with the next 
operator and the following operand. 


Examples: 
$DEFINE 7, ,HDCONVERT (AO) @e*7 = +160 
$DEFINE 4, ,HDCONVERT(6,CO/20+18) ex4 = +00030 
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6.6.6.4 Other Operators 

The following sections detail various miscellaneous operators for 
the $DEFINE command. 

6.6.6.4.1 CLEAR Operator 

The CLEAR operator of the $DEFINE command enables the user to 


clear the current total result or the last result determined in 
the $DEFINE command. 


Format: 
Ta 
CLEAR 
T' 
Parameters: 
L specifies that the last result determined is 
to be reset. 
oe the current total result is to be reset. 


Functional Details: 


Use of the CLEAR (L) form of this operator resets the last result 
even if a skip was performed. The last result depends on the 
value the last operator (except logical operators) determined. 


Examples: 


The following is an example of how to add the default extension 
-FTN to afd. The fd passed in the CSS call is allowed with or 
without an extension. 


BUILD TEST.CSS 

$DEFINE 5,,ST(@1l) EXT (=) LU2 <L(L) GO O ST(.FTN) 
$WR @*5 

$EX 

ENDB 
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This example CSS tests to see if an extension is included in the 
CSS call. If an extension is specified, it is not changed. If 
no extension is specified, the default extension .FTN is added. 
If this CSS was called with the following, the results would be 
as follows: 


TEST SYS:ABC The result @*5 = SYS:ABC.FTN 
TEST BBBB.XYZ The result @*5 = BBBB.XYZ 


6.6.6.4.2 CURRENT Operator 
The CURRENT operator of the $DEFINE command is used to determine 


current information within the user's environment and to assign 
that information as the value of the variable being defined. 


Format: 
/( BATCH 
DATE 
EOT 
CURRENT GROUP 
INTERACTIVE 
PRIVATE 
TIME 
.L USERNAME 
Parameters: 
BATCH in batch mode, the value returned is the batch 


job fd; in interactive mode the value is 
undef ined. 


DATE the value returned is the current date in the 
format mm/dd/yy or dd/mm/yy depending on the 
format selected at OS/32 sysgen. 


EOT the value returned is the last end of task 
code generated. A maximum of four digits is 
allowed. Leading zeros are dropped. 


GROUP the value returned is the five digit current 
group account number with leading zeros. 

INTERACTIVE in interactive mode the value returned is' the 
interactive device name; in batch mode the 


value is undefined. 


PRIVATE the value returned is the five digit current 
private account number with leading zeros. 
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TIME causes the current time (hh:mm:ss) to be 
returned. 


USERNAME causes the current username to be returned. 


Example: 


Execution of the following CSS will cause the current time to be 
output. 


BUILD TIME.CSS 

$DEFINE 5, ,CURRENT(TIME) 
$WR @*5 

$EX 

ENDB 


6.6.6.4.3 DVOLUMENAME Operator 


The DVOLUMENAME operator of the $DEFINE command enables the’ user 
to determine default volume names such as SYSTEM volume, SPOOL 
volume, etc., and assign the name as the value of the defined 
variable. 


Format: 
PRIVATE 
ROLL, 
DVOLUMENAME SPOOL 
SYSTEM 
TEMP 
Parameters: 
PRIVATE returns the volume name of the users) default 
volume. 
ROLL returns the volume name of the ROLL volume. 
SPOOL returns the volume name of the SPOOL volume. 
SYSTEM returns the volume name of the SYSTEM volume. 
TEMP returns the volume name of the TEMP volume. 


Functional Detail: 


The volume name returned is always followed by a colon (:). 
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Examples: 


Assume that volume SCRT/TEMP has been set at the system console. 
$DEFINE 6, TEMPVOL, DVOLUMENAME (TEMP ) 

Reference by variable would return SCRT: 
$SWR @*6 

Reference by variable name would also return SCRT: 
$WR @* /TEMPVOL/ 


6.6.6.4.4 REQUIRED Operator 


The REQUIRED operator of the $DEFINE command enables a user to 
designate a new internal variable as required; that is, the 
variable must have a defined value. If the new internal variable 
designated as REQUIRED is not defined within the CSS, execution 
of the CSS is paused and the user is prompted at the user's MTM 
console to supply a definition for the required variable. 


Format: 


REQUIRED | (pame]) | 
Parameters: 


name is an optional 1- to 8-character name for the 
required new internal variable that MTM will 
use when the user is prompted at the user's 
MTM terminal. This name can be composed of 
any of the letters A through Z. 


Functional Details: 
The REQUIRED operator must be the last operator in a §$DEFINE 


command. All blanks between the parentheses and between the name 
are dropped. 
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The name for the required new internal variable that is displayed 
to the user console is one of the following (in order of 
precedence): 


@ the name specified in the name field of the REQUIRED operator, 


@ the name used in the $DEFINE command, or 


@ the number specified in the $DEFINE command. 


Examples: 


The above CSS identifies three new internal variables (3, 4 and 
5) as required variables. 


BUILD TEST.CSS 

$DEFINE 3,LISTDEV, REQUIRED 

$DEFINE 4,OPTION,REQUIRED (NEWNAME ) 
$DEFINE 5, ,REQUIRED 

$EXIT 

ENDB 


If this CSS is called as follows, the following message prompts 
will be issued at the user's console: 


*TEST CSS call without parameters 

-GIVE LISTDEV= Prompt for the first required variable; 
the variable name is’ used in the name 
field. 

-GIVE NEWNAME= Prompt for second required variable; the 


name in REQUIRED field is used. 


-GIVE IVAR 005= Prompt for third required variable; the 
variable number is used. 


6.6.6.4.5 SEARCH Operator 


The SEARCH operator of the $DEFINE command enables the user to 
perform string searches for matches with specified keywords 
passed in the CSS call. On each match found, the string 
(including the keyword) is moved to the value of the new variable 
defined in the §$DEFINE command. 
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Format: 


d,' 
SEARCH delimiter, \, [keyword [ keyword, Sales 'keywordn] | [str ing, [dostr ing, ] |aelimiter, 
+ : 


‘da, 


Parameters: 


delimiter, is one of the following character pairs used 
to delimit the SEARCH operator specifications: 


delimiter, ...delimiter, = 


rN ee ff = SE 
ee ee 


The character pair chosen as the specification 
delimiter must not appear in the SEARCH 
operator specifications or as a string 
delimiter (d,). 


do is the string delimiter used to separate the 
strings to be searched. The string delimiter 
can be any character except CR or = semicolon. 
If the 'd,' option is used, the delimiter (d2) 
following the matched string is not included 
when the string is moved. If the '‘'dot' 
delimiter is used, the delimiter (d,) is 
included when the string is moved. 


keyword, is a l- to 8-character (A through Z) keyword. 
..-keywordn A keyword specification can be further defined 
to show the minimum number of characters’ that 
can be used to reference the Keyword. This is 
accomplished by separating the required 
characters of the keyword and the _ optional 
characters of the keyword with a period. For 
example: 


OP.TION 


The keyword name is OPTION, but a call 
specifying OP= will reference this keyword. 
Multiple keywords can be defined in a SEARCH 
operator. All strings are searched for 
matches with each defined keyword. Multiple 
keywords are separated by a ' mark. 
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string, is a character string that can contain 


--.string, any character except CR or semicolon. Null 
strings are allowed. The specified string is 
searched for any matches with keywords. If a 


positional parameter reference is specified 
(@1, @2) the string to be searched can be 
passed in the CSS call. 


Functional Details: 


The beginning of a string is tested for a match with the 
specified keywords. The search for a match begins with the first 
string. If one of the defined keywords matches a string entry, 
this string is moved to the new variable's value. The move 
includes leading blanks, the keyword and all following characters 
up to the next string delimiter (d2) or: including the string 
delimiter if the 'do+ delimiter was specified. This process is 
repeated for each string to be searched. For example, if the 
keyword is: 


OPTION 
the string delimiter (d.) is: 
a 
and the string to be searched is: 
--.# OPT = HOLL BATCH # ... 
The new variable being defined has a value of: 
OPT = HOLL BATCH 
Example: 
The following CSS identifies the pound sign as the _ string 


Gelimiter; keywords are OP.TION and BA.TCH; the string to be 
searched is @l, the first parameter passed in the CSS call. 


BUILD TEST.CSS 

$DEF 5,,SEARCH('#',OP.TION'BA.TCH, @1) 
$WR @*5 

$EX 

ENDB 
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When calling the above CSS with the following call: 
TEST OP/AAAA# BATCH # SOURCE 


the first string searched is OP/AAAA. A match with the first 
keyword is found OP.TION. OP/AAAA is moved to the variables 
value. The next string searched is BATCH. A match with the 
second keyword is found BA.TCH. BATCH is moved to the variables 
value. The next string searched is SOURCE. No match is_ found. 
The subsequent value of $WR @*5 is OP/AAAA BATCH. 


If calling TEST.CSS with the following: 
TEST xx # BATCH # BA/AAA # YY # OPTI 


the first string searched (xx) has no match. The second string 
searched (BATCH) matches a keyword. The third string searched 
(BA/AAA) matches a keyword. The fourth string (YY) has no match. 
The fifth string searched (OPTI) matches a _ keyword. The 
subsequent value of $WR @*5 = BATCH BA/AAA OPTI. 


6.6.6.4.6 STRING Operator 
The STRING operator of the $DEFINE command enables the value of 
the new variable being defined to be a user-specified string. 
Format: 

STRING delimiter, string delimiter, 


Parameters: 


delimiter is any of the following characters that 
delimits the beginning and end of the string: 


eee ee 


The character used as the delimiter should 
never appear within the string. 
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string is a character string that 


characters except CR 


contain any 


the delimiter 


character. This string becomes the value of 
the new variable being defined in the $DEFINE 
command. Leading and/or trailing blanks are 


included. 


Example: 


The following CSS is built: 
BUILD TEST 
$DEFINE 7,, STRING (ABC) ST # A ($$) A# 
$WR [@*7] 


SEX 
ENDB 


Call the above CSS with the following call: 


*TEST 


The resulting output of the $WR @*7 statement is: 


[ABC A ($$) A] 
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6.6.7 $EXIT Command 


The $EXIT command terminates a CSS _ procedure. Control is 
returned to the calling CSS procedure or the terminal if the CSS 
procedure was called from the terminal. All commands on_ the 


lines after the $EXIT command are ignored. 


Format: 


SEXIT 
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6.6.8 §FREE Command 


The $FREE command frees one or more local or global variables. 
This command has no effect on new global or new internal 
variables. 


Format: 
$FREE varname, it bd ,varname, | 
Parameter: 


varname, is a 1l- to 8-character name specifying the 
-..-Varname, variable whose name and value are to be freed. 


Example: 


 $FREE @A 
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6.6.9 $GLOBAL Command 


The $GLOBAL command names a global variable and specifies the 
maximum length of the variable to which it can be set by the §SET 


command . 


Format: 


a oe (| nal SY 


Parameters: 


varname 


length 


Example: 


$GLOBAL @A(6) 
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is a 1- to 8-character name (the first 
character is alphabetic) preceded by the @ 
sign, identifying a global variable. 


is a decimal number from 4 through 32 
specifying the length of the variable defined 
by the $SET command. If this parameter is 
omitted, the default is 8. 


{ $JOB AND 


6.6.10 $JOB and $TERMJOB Commands 
The $JOB and $TERMJOB commands set the boundaries of a CSS job. 


The $JOB command indicates the start and the $TERMJOB command the 
end of a CSS job that contains all the user CSS commands. 


Format: 


PROCESSORT IME 
$JOB =maxtime 
CPUT IME 


|, classid=iocount, | |, ..-,classid=iocount,, | 


* 


STERMJOB 
Parameters: 


PROCESSORTIME= maxtime is a decimal number specifying the 


CPUTIME= maximum processor time to which the CSS 
routine is limited. If this parameter is 
omitted, the default established at MTM sysgen 
is used. If 0 is specified, no limits are 
applied. 

classid= is one of the 4-character alphanumeric 


mnemonics specified at MTM sysgen that is 
associated with each specified device or file 
class. 


iocount is a decimal number specifying the maximum 
number of input/output (1/0) transfers to 
which the CSS routine is limited for that 
class. If this parameter is omitted, the 
default established at sysgen time is used. 
If O is specified, no limits are applied to 
that class. 
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Functional Details: 


The $JOB and §$TERMJOB commands are not necessary in a CSS 
procedure. They can be used, however, to prevent errors in one 
CSS job from affecting other CSS jobs. If a CSS job contains an 
error, the statements remaining in that job are skipped untila 
$TERMJOB command is found. The next command executed is the 
first command found after a §$TERMJOB- command. If the next 
command is a $JOB command signifying the start of a new CSS job, 
it could be skipped because the system is looking for a §$TERMJOB 
that signifies the end of the CSS job containing the error. 


The CSS job containing an error is aborted, and the end of task 
code is 255. The $JOB command resets the end of task code to 0 
for the next CSS job. 


Interactive jobs have no default limits established at sysgen 
time. The user can specify central processing unit (CPU) time 
and I/O transfer limits for a particular job through the $J0B 
command. 


Any limits in the $JOB command found in a batch stream are 
ignored if limits were already specified in the SIGNON command. 
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6.6.11 $LOCAL Command 


The $LOCAL command names a local variable and specifies the 
maximum length variable to which it can be set by the $SET 


command. 


Format: 


Parameters: 


is a 1l- to 8-character name (the first 


varname 
character is alphabetic) preceded by the @ 
sign, identifying a local variable. 

. Length is a decimal number from 4 through 32 
specifying the length of the variable defined 
by the $SET command. If this parameter is 
omitted, the default is 8. 

Example: 


$LOCAL @A(4) 
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6.6.12 $PAUSE Command 


The $PAUSE command suspends execution of a CSS procedure. 
Format: 
SPAUSE 
Functional Detail: 
When $PAUSE is entered, the CSS procedure remains suspended until 


the $CONTINUE command is continued or the $CLEAR command is 
entered to terminate a procedure suspended by a $PAUSE. 
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6.6.13 PRIOR Command 


The PRIOR command is used in CSS files to set the priority for a 
subsequently loaded task. This command is available in CSS files 
from the system account, from privileged users of MTM (to raise 
or lower the priority of a susbsequently loaded task) and to 
nonprivileged MTM users (to lower the priority of a subsequently 
loaded task relative to the user's MTM priority.) Nonpr ivileged 
users of MTM cannot use the PRIOR command to raise the priority 
of a task above their MTM priority. 


Format: 


PRIOR n 


Parameter: 


n is a decimal number specifying the priority of 
the susbsequently loaded task relative to the 
priority of MTM. hn may range from 1 through 
255 when the PRIOR command is in a CSS file 
from the system account or from a privileged 
user. m may range from 12 through 255 when 
the PRIOR command is in a CSS file froma 
nonprivileged MTM user. 


Functional Details: 


The PRIOR command can be entered from CSS files only. If the 
task loaded subsequent to a PRIOR command generates a load error 
or goes to end of task, the priority specified in the PRIOR 
command is reset to the default MIM priority. 


If an invalid priority number is specified in a PRIOR command 
(i.e., 1 through 11 by a nonprivileged user), the invalid 
priority specification is ignored, no message is generated and 
the default MTM priority is used. 
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6.6.14 $RELEASE Command 


The $RELEASE command is used to release a new global or new 
internal variable from its current value and delete the released 
variable's associated buffer. This command has no effect on 
local or global variables. 


Format: 
n1/N2 
GVARIABLE 
SRELEASE 4Ty peso eNp7 
IVARIABLE 
Parameters: 
GVARIABLE indicates that the variables to be released 


are new global variables. 


IVARIABLE indicates that the variables to be released 
are new internal variables. 


n,/Nny indicates that all variables (of the type 
selected via the preceding parameter) between 
the range n;,/np be released. nis a decimal 
number between 1 and the maximum value allowed 
at MTM sysgen for the specified variable type. 


Ny...Np mn is a decimal number of a variable (either 
new global or new internal) or variables to be 
released. n must’ be within the range 1 and 


the maximum value allowed at MTM sysgen _ for 
the specified variable type. 


ALL specifies that all new internal or new global 
variables be released. This is the default if 
no specific variable numbers are specified. 


Functional Details: 


This command can be entered in command, task-loaded, task- 
executing and CSS modes. 
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In order to reduce buffer overhead, variables that are no longer 
being used should be released. If this command is directed to a 
variable that was already released, the command is ignored and no 
error message is generated. 


Examples: 


All new global variables from 1 through 5 are released. 
$RELEASE GVARIABLE, 1/5 


The new internal variables numbered 16, 19, 18 and 25 are 
released. 


$RELEASE IVARIABI.E, 16, 19, 18, 25 
All new internal variables are enclosed. 
$RELEASE IVARIABLE, ALL 
NOTE 
This command does not release local and 


global variables created with the $§SET 
command. 
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6.6.15 $§SET Command 


The $SET command establishes the value of a named local or global 
variable. This command has no effect on new global or new 
internal variables. 


Format: 
$SET varname=e 
Parameter: 


varname= e is an expression, variable or parameter 
established as the value of the variable. 


Functional Details: 


Expressions for this command are concatenations of variables, 
parameters and character strings. No operators are allowed in an 
expression. If a character string is included in an expression, 
it must be enclosed between apostrophes ('). If an apostrophe is 
part of the character string, it must be represented as_ two 
apostrophes (''). 


The initial value of the variable is blanks. This allows’ the 
S$IFNULL and $IFNNULL commands to test for a null or not null 
value. 


Examples: 
$SET @A = @A1LGA2 
$SET @A = @1 
$SET @A = 'A''B! 
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6.6.16 SET CODE Command 
The SET CODE command modifies the current end of task code. 


Format: 
SET CODE n 


Parameter: 


is a decimal number from 1 through 254. 
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6.6.17 $SKIP Command 


The $SKIP command is used between the $JOB and $TERMJOB commands. - 
The $SKIP command indicates that subsequent commands are to be 
skipped until a $TERMJOB command is found. The end of task code 
is set to 255. 


Format: 


SSKIP 
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6.6.18 $WAIT Command 


The $WAIT command suspends execution of a CSS for a specified 


period of time. 


The $CONTINUE command can be used to override this command and 


continue the CSS. 


Format: 


Parameter: 


Functional Details: 


is a decimal number from 1 through 900 
specifying the number of seconds CSS execution 
will be suspended. If this parameter is 
omitted, the default is 1 second. 


The $WAIT command will only function from a CSS routine. 


The $CONTINUE command can be used to override this command and 


continue the CSS. 
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6.6.19 $WRITE Command 


The $WRITE command writes a message to the terminal or log device 
for both interactive and batch jobs. 


Format: 
SWRITE text [;] 
Functional. Details: 
The message is output to the terminal or log device. It begins 


with the first mnonblank character after $WRITE and ends with a 
semicolon or CR. The semicolon is not printed. 
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6.7 LOGICAL IF COMMANDS 


The logical IF commands all start with the three characters, $IF, 
and allow one argument; e.g., $IFE 225, $IFX B.CSS, $IFNULL @1. 


Each logical IF command establishes a condition that is tested by 
the CSS processor. If the result of this test is true, commands 
up to a corresponding $ELSE or $ENDC command are executed. If 
the result is false, these same commands are skipped. 


The $ENDC command delimits the range of a logical IF; however, 
nesting is permitted so each $IF must have a corresponding $ENDC. 


In the following examples, the ranges of the various logical IF 
commands are indicated by brackets. 


$F $IF $1F 
oe ee $F 
$ENDC $ENDC 
$ENDC $1F 
$ENDC 
$ENDC 
There is no restriction on the depth of nesting. Logical IF 


commands are used within a CSS file. They differ from previous 
CSS commands in that each one tests a specific built-in, defined 
condition rather than causing a specific action. 


The logical IF commands fall into three categories: 


e end of task code testing, 
e file existence testing, and 


@ parameter existence testing. 
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6.7.1 End of Task Code Testing Commands 


The end of task code is a halfword quantity maintained for each 
user by the system. It is set or reset in any of the following 
ways: 


SET CODE n This command, which can be included in a CSS 
file or entered at the terminal, sets the end 
of task code to n. 


$JOB As part of its start job function, this 
command resets the end of task code for the 
current CSS task to QO. 


Command error A command error causes the CSS mechanism to 
skip to §$TERMJOB assuming that a $JOB was 
executed. (If no §$JOB was executed, CSS 
terminates. ) To indicate that the skip took 
place, the end of task code is set to 255. 


$SKIP This command has the same effect as a command 
error. 


End of task When any task terminates by executing the’ end 
(SVC3,n) of task program command (SVC3,n), the end of 
task code for that task is set to n. 


CANCEL When a task is cancelled, the end of task code 
is set to 255. 


The six commands available for testing the current end of task 
code are as follows: 


$IFE n Tests if end of task code is equal to n. 

$IFNE n Tests if end of task code is not equal to n. 

$IFL n Tests if end of task code is less than n. 

$IFNL n Tests if end of task code is not less than n. 

$IFG n Tests if end of task code is greater than n. 

$IFNG n Tests if end of task code is not greater than 
n. 


In all cases, if the results of the test are false, CSS _ skips 


commands until the corresponding $ELSE or $ENDC. If a CSS 
attempts to skip beyond end of file (EOF), a command error is 
generated. 
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6.7.2 File Existence Testing Commands 


There are two commands dealing with file existence: 


$IFX fd Tests fd for existence. 

SIFNX fad Tests fd for nonexistence. 
If the result of the test is false, CSS _ skips to the 
corresponding $ELSE or $ENDC command. If a CSS attempts to skip 
beyond EOF, an error is generated. 
If the fd is omitted when entering $IFX, the result is always 
considered false. If §$IFNX is entered without the fd, the result 
is always considered true. 


6.7.3 Parameter Existence Testing Commands 


There are two commands dealing with the existence of parameters: 


SIFNULIL @n Tests if @n is null. 

SIFNNULL a@n Tests if @n is not null. 
If the result of the test is false, CSS skips to the 
corresponding $ELSE or $ENDC command. If such skipping attempts 
to skip beyond EOF, a command error is given. 
The use of the multiple @ notation to test for the existence of 


higher level parameters is permitted. In addition, a combination 
of parameters can be tested simultaneously. 


Example: 
$IFNU @1@2@3 


This tests to insure the logical AND of @1, @2 and @3 does not 
exist; mone of the positional parameters can exist if the 
condition is to be true. If any of the three is present, the 
test result is false. 
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6.7.4 $ELSE Command 


The $ELSE command is used between the $IF and $ENDC command to 
test the opposite condition of that tested by $IF. Thus, if the 
condition tested by $IF is true, §$ELSE causes commands to be 
skipped up to the corresponding $ENDC. If the condition is 
false, $ELSE terminates skipping and causes command execution to 
resume. 


Format: 


SELSE 
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6.7.5 §GOTO and $LABEL Commands 
The $GOTO command is used to skip forward within a CSS procedure. 
The $LABEL is used to define the object of a $GOTO. 


Format: 


SGOTO label 


SLABEL label 
Parameter: 


label is from one to eight alphanumeric characters, 
the first of which must be alphabetic. 


Functional Details: 
The $GOTO command causes all subsequent commands to be _ ignored 
until a $LABEL command with the same label as the $GOTO command 


is encountered. At that point, command execution resumes. 


The $GOTO cannot branch into a logical IF command range, but’ can 
branch out from one. 


An example of an illegal §$GOTO is: 


SIF Condition 
$GOTO OUTIF 


SENDC 
$IF Condition 
$LABEL OUTIF 


The $LABEL occurs within an IF block (the second IF condition) 
that was not active when $GOTO was executed. 
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The following is valid, however: 


SIF Condition 
$GOTO OUTIF 
SENDC 

SIF Condition 
$SENDC 


$LABEL OUTIF 
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| $IFEXTENSION | 

6.7.6 §$IFEXTENSION Command 

The $IFEXTENSION command is used to test for the existence of an 
extension for a given fd. If the extension exists, subsequent 
commands are executed up to the next $ELSE or $ENDC command. If 


an extension does not exist, subsequent commands are skipped up 
to the next $ELSE or $ENDC command. 


Format: 
SIFEXTENSION fd 
Parameter: 


fd . is the file descriptor to be tested to 
determine if an extension is included. 


Functional Detail: 


$IFEX (with no fd) is always considered false. $IFNEX (with no 
fd) is always considered true. 
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6.7.7 $IFVOLUME Command 

The $IFVOLUME command tests for the existence of a volume name 
an fd. If a volume exists, subsequent commands are executed 

to the next $ELSE or $ENDC command. If the volume is omitted 


the fd, subsequent commands are skipped up to the next $ELSE 
$ENDC command. 


Format: 


SIFVOLUME fd 


Parameter: 


fa is the file descriptor tested to determine 
a volume name is included. 


if 
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6.8 LOGICAL IF COMMANDS COMPARING TWO ARGUMENTS 


The following logical IF commands are used to compare’ two 
arguments. They differ from the other logical IF commands in 
that they do not test specific built-in conditions, but test 
conditions provided by the user instead. These commands are 
available only with MTM. 


$IF...EQUAL 
$IF...NEQUAL 
$IF...GREATER 
$IF...NGREATER 
$IF...LESS 
$IF...NLESS 


For each of the logical commands, two arguments are compared 
according to the mode. There are three valid modes: 


@e Character 
@ Decimal 


@ Hexadecimal 


For character mode, the comparison is left-to-right and is 
terminated on the first pair of characters that are not the same. 
If one string is exhausted before the other, the short string is 
less than the long string. If both strings are exhausted at’ the 
same time, they are equal. For character mode, the arguments can 
be enclosed in double quotes if they contain blanks. The quotes 
are not included in the comparison. 


For decimal and hexadecimal mode, the comparison is performed by 
comparing the binary value of the numbers. 


If, after comparing the arguments for each cf the commands, the 
condition is determined to be true, subsequent commands are 
executed up to the corresponding $ELSE and $ENDC. If the 
condition is false, commands are skipped up to the corresponding 
$ELSE or $ENDC. 


6-72 48-043 FOO RO2 


6.8.1 $IF...EQUAL, $IF...NEQUAL Commands 


The $IF...EQUAL command is used to determine if two arguments are 
equal, while the $IF...NEQUAL is used to determine if two 
arguments are not equal. 


Format: 
CHARACTER 
$IF DECIMAL, arg, EQUAL arg, 
HEXADEC IMAL, 
CHARACTER 


$IF DEC IMAL, arg, NEQUAL arg, 


HEXADECIMAL, 


6.8.2 $IF...GREATER, $IF...NGREATER Commands 


The $IF...GREATER command is used to determine if arg, is greater 
than arg,. The $IF...NGREATER command is used to determine if 
arg, is not greater than arg,. 


Format: 
CHARACTER 
$IF DECIMAL arg, GREATER arg» 
HEXADEC IMAL, | 
CHARACTER 


$IF DECIMAL arg, NGREATER arg, 


HEXADEC IMAL, 
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6.8.3 $IF...LESS, $IF...NLESS Commands 
The $IF...LESS command is used to determine if arg is less’ than 


argo. The $I1F...NLESS command is used to determine if arg is 
not less than arg 


Format: 


CHARACTER 
$IF DECIMAL, arg LESS arg 


HEXADEC IMAL. 


CHARACTER 
SIF DECIMAL, arg NLESS arg 


HEXADEC IMAL, 
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CHAPTER 7 
SPOOLING 


7.1 INTRODUCTION 


The OS/32 package (Revision 6.2 or higher) now comes with two 
spooler tasks: 


@ the 0S/32 Spooler, and 


e the SPL/32 Spooler. 


Both spoolers offer input and output spooling capabilites to the 
multi-terminal monitor (MTM) user. The SPL/32 Spooler offers a 
more extensive range of features and capabilities than the 0S/32 
Spooler. The system administrator determines which spooler will 
be used on a system by selecting the appropriate system 
generation (sysgen) statement. Only one spooler can be active on 
the system at any given time. The OS/32 System Generation 
(Sysgen/32) Reference Manual presents detailed information 
regarding the procedures for sysgening either spooler. 


NOTE 


The manner in which pseudo devices are 
specified and used _ in the spooling 
environment differs among the two 
spoolers. Pseudo devices created for the 
OS/32 Spooler are not compatible with 
pseudo devices created for the SPL/32 
Spooler. Do not attempt to mix the 
various pseudo device types. 


7.2 THE OS/32 SPOOLER 


The OS/32 Spooler is Perkin-Elmer's first generation spooler. 
This spooler provides basic input and output spooling services 
with minimal flexibility and control over the spooling 
environment. The following sections detail the manner in which 
an MTM user can utilize the spooling capabilities of OS/32 
spooling. 
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7.2.1 Input Spooling 

Input spooling is a process whereby a card deck of information 
(such as source programs, operator commands, command substitution 
system (CSS) files or user data) is copied into a disk file for 
immediate or subsequent processing. 

7.2.2 Input Spooling Control Card Statements 

Each batch of cards to be spooled to disk must be preceded by a 
control card statement. This statement specifies the file 
descriptor (fd) to which the input data (card file) is to be 
spooled. The OS/32 Spooler provides two such control statements: 


e /@INPUT 


e@ /@SUBMIT 

7.2.2.1 The /@INPUT Control Statement 

The /@INPUT control statement is used to copy a card file to a 
specified fd on disk. The resulting file can be explicitly 


assigned and read by the user in order to access the _ spooled 
information. 


Format: 
/®@INPUT fd/actno [,DELETE ] 


Parameters: 


fd is the file descriptor of the disk file in the 
form of voln:filename.ext. The only required 
field is filename. If voln is omitted, the 


default spool volume is used. 


actno is the account number with which the terminal 
user signs on. 


DELETE specifies that if a file with the same name 
and account number already exists, that file 
is deleted and reallocated. 

CAUTION 
IF THE WRONG ACCOUNT NUMBER IS 


ENTERED, THE USER MIGHT DELETE 
ANOTHER USER FILE. 
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Example: 


A task requires five input data records in order to execute. In 
the following example, TEST.DTA in account 12 is identified as 
the file to which the five data records are to be spooled. If 


the file TEST.DTA currently exists on disk it will be deleted and 
reallocated as specified by the DELETE option in the /@INPUT 
statement. 


/@IN TEST.DTA/12,DELETE 
4 INPUT TEST 

122736 

545627 

889710 

632192 


/@ 
7.2.2.2 The /@SUBMIT Control Statement 
The spooler can also be used to submit batch jobs to MTM. This 


is done through the /@SUBMIT control statement. This statement 
copies a card file to disk and then submits the file as a_ batch 


job. The commands located within the spooled batch file are 
executed in sequence. The file remains on the disk after 
execution. 


To add batch jobs to the batch queue via the spooler, submit a 
control statement card with the following format: 


Format: 
/BSUBMIT fd/actno [,DELETE | 


Parameters: 


fa is the name of the command file (i.e., the 
batch job) that is to be placed on the batch 
queue. 

actno is the account number with which the terminal 


user signs on. 
DELETE specifies that if a file with the same name 


and account number exists, that file is to be 
deleted and reallocated. 


The end of a card file is signified by placing the symbols /@ in 
columns 1 and 2 of the last card in the file. 
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See the 0S/32 System Support Utilities Reference Manual for more 
detailed information on the OS/32 Spooler. 


The following examples are presented to illustrate two methods of 
submitting a batch job through the OS/32 Spooler. 


Method 1: 


A CSS file named DATA is copied from a card file to a disk file 
named TEST.CSS on account number 12 on the default spool volume. 
If TEST.CSS already exists, it is deleted and reallocated. This 
is done as follows: 


/@INPUT TEST.CSS/12,DELETE 
LO DATA 

AS 1,DATA.DTA 

AS 3,PR: 

AS 5,MAGL: 

START 

/@ 


The CSS file TEST.CSS created with the previous /@INPUT statement 
can now be submitted as a batch job named TEST.JOB via the 
/@SUBMIT control statement. If a file already exists on the disk 
with the name TEST.JOB, it is deleted and reallocated. When 
running concurrent batch jobs, each signon [ID must be unique. 


/@SUBMIT TEST.JOB/12,DELETE 
SIGNON ME,12,PASSWD 

LOG PR: 

TEST.CSS 

SIGNOFF 

/@ 


Method 2: 


The procedures shown in Method 1 can also be performed in one 
step, as the following example shows. In this example the 
process of creating a CSS file and then submitting the CSS file 
as a batch job is combined into one step. If the file TEST.JOB 
already exists on the disk, it is deleted and reallocated. After 
this batch job is completed, the file TEST.JOB remains on the 
disk. 
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/@SUBMIT TEST .JOB/12,DELETE 
SIGNON ME, 12,PASSWD 

LOG PR: 

LO DATA 

AS 1,DATA.DTA 

AS 3,PR: 

AS 5,MAGI1: 

START 

SIGNOFF 


/@ 


7.2.3 Output Spooling 


Output spooling is a process by which information destined for a 
physical output device, such as a printer or card punch, is 
initially copied to a disk file. This file is then copied by the 
spooler to the physical output device on a task priority basis. 
This process’ enables multiple tasks to be generating output for 
the same output device since output is not routed directly to the 
device as it is generated. 


To make use of the output OS/32 Spooler, assign any logical units 
to be printed or punched to one or more pseudo devices. As_ soon 
as the logical unit (lu) is closed, the 0S/32 Spooler will 
automatically print or punch the results. Printing or punching 
may be delayed because of a backlog to the device. 


There is no limit to the number of tasks or logical units” that 
can be assigned to a pseudo device. After the user makes an lu 
assignment to a pseudo device, the following occurs’ internally: 
the operating system automatically intercepts all assignments to 
that pseudo device and allocates an indexed file called a spool 
file on the spool volume. Subsequent output calls cause data to 
be written to this file and not to the device. The spooler 
supports both image and formatted writes. 


When the lu assigned to the spool file’ is closed, the filename, 
task name and priority are placed into the spooler print or punch 
queue. The queue is maintained as a file on the spool volume. 
If there is an entry on the queue, the output spooler begins 
printing or punching and stays active as long as there is 
something on the queue. Files are spooled and output on a task 
priority basis. The user must ensure that sufficient disk space 
is available to accommodate output spooling. The user task 
(u-task) is responsible for handling end of medium (EOM) status 
while writing to spool files within their own standard I[/O error 
recovery routines. 


Printing multiple copies of a disk file or punching multiple 
copies of a card deck is accomplished through use of the spooler. 
To print or punch a disk file using the spooler, issue a command 
through MTM from the terminal. This is done with the PRINT and 
PUNCH commands (see Sections 2.38 and 2.39). 
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If the device specified in a PRINT or PUNCH command does not 
support printed output or output punching, respectively, the 
output will be generated in the way that is supported on the 
specified device. 
For print files, a header page precedes each file printed. The 
header page has the format: 

USERID 

ACCOUNT NUMBER 

TIME OF DAY 

DATE 
When a file is directed to a card punch file, each output’ record 
is 80 bytes in length. A header card precedes the punched 
output; a trailer card terminates the punched output. Header 
suppression is not supplied. 
Examples: 
To list and punch a file named TEST.CSS in account number 12 on 


the. volume MTM using the OS/32 spooler, enter: 


SIGNON ME,12,MEPASS 
PRINT MTM: TEST.CSS 

PUNCH MTM:TEST.CSS 

SIGNOFF 


The header page for the print examples reads: 


TEST 
AC=00012 
14:36:50 
07/08/77 
7.2.4 Spooling Errors 
The following message is generated by the operating system in 


response to a spooler command. 


FILE voln:filename.ext/acct NOT ENTERED ONTO PRINT QUEUE 


7-6 48-043 FOO RO2 


A spool file was closed but the spooler task was not loaded or 
started. The system operator can reenter a .SPL PRINT command 
when the spooler is started. 

7.3 THE SPL/32 SPOOLER 

The SPL/32 Spooler is the latest spooling product offered with 
the OS/32 operating system. SPI/32 will only execute on systems 
running OS/32 Revision RO6.2 or higher. 

SPL/32 offers increased flexibility in creating and _ controlling 


the spooling environment of a system. Some of the features of 
SPL/32 include: 


e The number of output devices is dependent only on the = amount 
of available memory 


e The capability of retaining a spooled output file after it is 
sent to a device 


e The cability of holding spooled files from output processing 

e The option to backspace, forward space or rewind a file that 
is currently being output by the spooler, and then resume 
output 


e The option to produce up to 255 copies of an output file 


e The option to print informative header and trailer pages to 
identify output files 


@e The capability of using preprinted forms and testing for form 
alignment before output 


@e The capability of altering the output requirements of a file 
waiting to be output 


e The capability of altering the order in which files are output 


e The capability of controlling devices within the output 
spooling environment 


e The capability to quiesce the entire output spooling function 
or individual devices in an orderly fashion 


@e The capability to add or drop spool devices dynamically 
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7.3.1 SPL/32 and Multi-Terminal Monitor (MTM) Interaction 


The SPL/32 capabilities available to an MTM terminal user are 
directly dependent upon the manner in which the spooling 
environment is configured. MTM users of SPL/32 should see _ the 
SPL/32 Administration and Reference Manual for specific details 
on the commands and configurational considerations of using 


SPL/32. 


In general, MTM should be designated the primary control task for 
SPL/32. This will enable all SPL/32 spooling facilities at the 
MTM terminal level. 
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APPENDIX A 
MULTI-TERMINAL MONITOR (MTM) COMMAND SUMMARY 


64 


ALLOCATE fd, 


ASSIGN lu,fd|]/, 


BFILE (fd,] lu 


address | 
BIAS f 
x 
BREAK 


BRECORD [fa,] lu 
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fd [APPEND] 


BUILD 
lu 


ENDB 


CANCEL 
dese on Fideeussinn tt 
ALL 


CONTINUE [address | 


DELETE fd; [,fd2,...,fdq] 


‘GVARIABLE 
DISPLAY n 
IVAR IABLE 


DISPLAY ACCOUNTING E : 


DISPLAY DEVICES E 


DISPLAY DFLOAT Ey 
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DISPLAY FILES|, 


fd 
DISPLAY FLOAT | , | - 


DISPLAY 


DISPLAY 


DISPLAY 


DISPLAY 
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| MESSAGE 
PROMPT 
ENABLE< ETM 


TYPEAHEAD 


SVARIABLE 


FFEILE [fd,] lu 


FRECORD [fd,] lu 


mnemonic 
HELP 
x 


segsize increment 
INIT fd |, ae 


userid 


MESSAGE message 


.QPERATOR 
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Gata, 


1 [-data,,...,datan] 


MODIFY saaress,|| 


OPTIONS | Bere | 4 paris \ {, NONRES IDENT ] [ [neu [r)] F wie] | 


AFCONT I NUE SVCCONT INUE 


PASSWORD current password, new password 
PAUSE 


MESSAGE 

PROMPT 
PREVENT< ETM 

TYPEAHEAD 


$VARIABLE 
PRINT fd [,DEVICE=pseudo device] [COPIES=n] [,DELETE] [,VFC ] 
PUNCH fd [,DEVICE=pseudo device] [,COPIES=n] [,DELETE] [,VFC] 


PURGE fa 


GVARIABLE 
RELEASE 
IVAR [ABLE 


RENAME oldfd,newfa 
REPROTECT fd,new keys 


REWIND [fd,] lu 
or 


RW (fd,] lu 
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ADD, 


actno, [7...,max actno] 
RYOLUME voln, REMOVE 


USERS| ,({actno, - actno2 


SEND message [;] 
SET GROUP n 


SET KEYOPERATOR [character ] 


SET PRIVATE n 


SIGNOFF 


fda 
SIGNON vser id, actno,pasewora| ,zxvtroxann-{ | 


NULL [:: ] 
PROCESSORT IME 
‘ =maxt ime 


CPUT IME 
[ ;classid~iocount, [; ...,classid=iocountaj] | 
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\ ; Bee! ot a Lag 1 Penioninis ai 
pms NODELETE 


[, BLOCK=bsize/isize] 


address 
START | 9 | _( |L parameter, ,...,parametery | 


SUBMIT fd [,DELETE][,PRIORITY=priority] 
taskid )- 
TASK 
; .BGROUND 
CONTIGUOUS ,fsize 


TEMPFILE lu, INDEX|, i 
126 


; ch ls. tz 
ites al) 


wal 


VOLUME [voln] 


WEILE [fd,] lu 
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CONTIGUOUS ,fsize 


—s . 


|) 


APPENDIX B 
PROGRAM DEVELOPMENT COMMAND SUMMARY 


ADD source-fd [,compile-css](,arg,,...arg,7] 


list-op 


filename 


COMP ILE Pp [, loadinc] [, calops] 


E [a] [, copy-fda] Lmlbcss] 


filename 


Bg , Loadin ,;ma 
COMPLINK Ate Pecepal). [ c] [map] 
L [A] 
E [A] [,work ] [,worklim ] 


ee .} 


filename COMMAND=command 
EDIT ; F 


LENGTHS |T4ae 


NULL | 
ENV 
filename [; subenv_] 


filename 
EXEC | ) ; [,runops ] [, runincr ] 
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LINK 


List | 


REMOVE fd 


filename 


seas | 
x 


filename 


[map] [;work][,worklim] [,dms] 
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APPENDIX C 
COMMAND SUBSTITUTION SYSTEM (CSS) COMMAND SUMMARY 


a lchar2, [charlchar2, ...charlchar2,] : 
% 


% new delimiter 


fd caialie 


$BUILD 
lu 


$ENDB 
$CLEAR 
S$CONT INUE 
SCOPY 


GVARIABLE 
S$DEFINE ¢ _ ____n?, [name] , operator, [operator ...operator,] 


SELSE 
SENDC 
SEXIT 


$FREE varname, ( bias ,varnamen | 


$GLOBAL varname (| 
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SGOTO label 


CHARACTER 
$1F DECIMAL. arg, 


HEXADEC IMAI 


CHARACTER 


$IF DEC IMAL arg, 


HEXADEC IMAL, 


CHARACTER 


$1F DECIMAL arg, 


HEXADECI MAL, 


CHARACTER 


SIF DECIMAL arg, 


HEXADEC IMAL. 


ee ONO i oC SN” 


CHARACTER 
$1F DECIMAL, arg, 


HEXADEC IMAL 


CHARACTER 
$IF DECIMAL arg, 


HEXADEC IMAL. 


$IFE n 


SIFEXTENSION fd 


$IFG n 


$IFL n 


EQUAL arg, 


NEQUAL arg, 


GREATER arg» 


NGREATER arg, 


LESS arg, 


NLESS arg, 
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RO2 


$IFNE n 
$IFNG n 
$IFNL n 
SILFNULL @n 
$IFNNULL @n 
SIFNX fd 
SIFVOLUME fd 


$IFX fd 


PROCESSORT IME 
$JOB =maxtime 
CPUT IME 


|, classid=iocount, | , - 


$TERMIJOB 


S$LABEL label 


length 
$LOCAL varname ee 
eS 


SNOCOPY 


SPAUSE 


PRIOR n 
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.,class id=iocount,, | 


length 
-,varname ||) 
e 


SRELEASE 


$SET varname=e 
SET CODE n 


SSKIP 


GWRITE text [; ] 


GVARIABLE 


IVARIABLE 
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APPENDIX D 
MULTI-TERMINAL MONITOR (MTM) MESSAGE SUMMARY 


ACCESS PRIVILEGE ADDRESS ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXxX 


An attempt was made to access a valid segment in an _ invalid 
mode; i.e., store into a write-protected segment; execute 


instructions from an execute-protected segment; load from a 
read-protected segment. 


ACCT-ERR 


The account number specified is not a valid account. 


ALIGNMENT FAULT INSTRUCTION AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXKXxX 


Data instruction not properly aligned to specific fields for 
fullword or halfword alignment. The memory fault address is 
the memory location that is not properly aligned. The memory 


fault address is given only on Perkin-Elmer Series 3200 
machines. 


ALLO-ERR TYPE=NAME 
A desired filename currently exists on the specified volume, 


or the block size of an indexed file exceeds Limit 
established at system generation (sysgen) time, 


or for an indexed file, a zero logical record length or data 
block size was specified. 


ALLO-ERR TYPE=TYPE 


The volume specified is not a direct access device. 


ALLO-ERR TYPE=VOL 


The volume name specified, or the name it defaulted to, is 
not the name of any of the disks currently on-line. 
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ACCT-ERR 


The account number specified is not valid. 


APUO-ERR 


OPTION NLPU is not valid for task linked with OPTION APUONLY. 


ARGS-ERR 
The amount of space between CTOP and UTOP is insufficient for 


placement of START command arguments by the command 
processor. 


ARITHMETIC FAULT AT XXXXXX 


A fixed or floating point error was detected at address 
XXXXXX, 


or an attempt was made to divide by zero. This only occurs 
on Perkin-Elmer Model 7/32 and 8/32 machines. 


ASGN-ERR 


The assign failed for reason denoted by TYPE field. 


ASGN-ERR TYPE=BUFF 


An attempt was made to assign a file when there was 
insufficient system space available to accommodate the file 
control block (FCB). 


ASGN-ERR TYPE=LU 
An attempt was made to assign to a logical unit (lu) that is 


greater than the maximum lu number specified at Link time. 


ASGN-ERR TYPE=NAME 


An assignment is being directed to a nonexistent file. 
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ASGN-ERR TYPE=PRIV 
The privilege to assign the file or device cannot be granted. 
The access privileges may be incompatible with other current 
assignments to the same file descriptor (fd), 


or a request was made to assign to a disk when bare disk 
privileges are not enabled, 


or requested privileges may conflict with user's file access 


privileges (e.g., assigning system file exclusive write only 
(EWO) when only shared read only (SRO) is valid). 


ASGN-ERR TYPE=PROT 


The file being assigned to is unconditionally protected (read 
and/or write keys=X'FF') 


or the read/write keys specified in the ASSIGN command do not 
correspond to those associated with the file, and the file is 
conditionally protected (read and/or write keys not X'00' or 
X'FF'). 

ASGN-ERR TYPE=SIZE 


An indexed file is being assigned and there is not’ enough 
room on the disk to allocate a physical block. 


ASGN-ERR TYPE=SPAC 


An assign is refused because the available task system space 
was exceeded. 


ASGN-ERR TYPE=TGD 


An attempt was made to assign a trap-generating device. 


ASGN-ERR TYPE=VOL, 


Volume name specified or defaulted to is not the name of any 
of the disks currently on-line. 


BTCH-ERR 


The batch capability was not started and is not available for 
a SUBMIT command. 
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BUFF-ERR 


The expanded command substitution system (CSS) line 
overflowed CSS buffer size. 


CLOS-ERR 


Close failed for reason denoted by TYPE field. 


DEFO-ERR 
More than eight characters were specified for a keyword, a 


new variable mame or a required name in the REQUIRED 
operator. 


DEF 1-ERR 
An illegal character is specified in a keyword or a required 


name specification. A through Z are the only valid 
characters, and they must be capital letters. 


DEF 2-ERR 


An empty additional keyword after a quote was used in a 
SEARCH operator specification. 


DEF 3 -ERR 


The specified variable name is already in use. 


DEF 5-ERR 


Division by zero attempted. 


DEF6-ERR 


Arithmetic fault - result is greater than Y'OFFFFFFF'. 


DEF 7-ERR 


A negative hexadecimal value was’ specified. Only positive 
values are allowed. 


DELE-ERR TYPE=ACCT 


An attempt was made to delete a file not on the _ user's 
private account. 
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DEL-ERR TYPE=ASGN 


An attempt is being made to delete a file that is currently 
assigned or is being processed by the CSS processor. 


DELE-ERR TYPE=BUFF 


There is insufficient memory available in system space to 
perform a delete function. 


DELE-ERR TYPE=DU 


An attempt was made to delete a file from a device that is 
not on-line. 


DELE-ERR TYPE=IO 


An input/output (1/0) error was encountered while attempting 
to delete a file. 


DELE-ERR TYPE=NAME 


File with a specified name was not found. 


DELE-ERR TYPE=PROT 
An attempt is being made to delete a file with nonzero 
protection keys. 

DELE-ERR TYPE=TYPE 
The volume name specified or defaulted to is not a direct 
access device. 

DELE-ERR TYPE=VOL, 
The volume name specified or defaulted to is not the name of 
any of the disks currently on-line. 

DINC-ERR 
The output from a DISPLAY, EXAMINE, or MODIFY command was 


terminated because the user task (u-task) was released or 
cancelled from the system console or by another task. 
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DUPLICATE USERNAME, FOREGROUND TASKNAME OR RESTRICTED USERID 
Userid is already in use, restricted or matches the name of 
a foreground task. 

FD-ERR 
The fd is syntactically incorrect or invalid, 
or a program on the disk is being loaded without enough 
system space. 

fd IS NOT A CONTIGUOUS FILE 
The INIT command can only be used to initialize contiguous 
files. 

FILE voln: filename. ext/acct NOT ENTERED ONTO PRINT QUEUE 
A spool file was closed but the spooler task was not loaded 
or started. 

FIXED POINT-ZERO DIVIDE ERROR AT XXXXXX 

NEXT INSTRUCTION AT XXXXXXX 
An attempt was made to divide by zero. Current instruction 
aborted, and next instruction at address XXXXXxX. 

FIXED POINT-OVERFLOW ERROR AT XXXXXX 

NEXT INSTRUCTION AT XXXXXX 
Fixed point arithmetic result is too large to be represented. 
Instruction aborts. Next instruction at XXXXXxX. 

FLOATING POINT-UNDERFLOW ERROR AT XXXXXX 

NEXT INSTRUCTION AT XXXXXX 
Results of floating point operation are too small to be 


represented; the instruction aborts. The next instruction is 
at XXXXXX. 


FLOATING POINT-OVERFLOW ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXX 
Floating point arithmetic procedure is too large to be 


represented; the instruction aborts. The next instruction is 
at XXXXXX. 
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FLOATING POINT-ZERO DIVIDE ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXX 


An attempt was made to perform a floating point divide by 
zero. 


FORM-ERR 


The command format is invalid or invalid account number 
specified. 


GOTO-ERR 


A $LABEL that is terminating the range of the §$GOTO is 
branching into an IF group. 


ILLEGAL INSTRUCTION AT XXXXXX 


The u-task attempted to execute an illegal instruction at 
location XXXXXxX. 


ILLEGAL SVC-INSTRUCTION AT XXXXXX 
SVC PARAMETER BLOCK AT XXXXXX 


The u-task attempted to execute an illegal supervisor call 
(SVC) at location XXXXxXxX. 


INVALID SEGMENT ADDRESS ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXX 


An attempt was made to access a memory location not within a 
valid mapped segment; i.e., an attempt to access a memory 
location outside of the task space: 


INVALID ACCOUNT 


Account number is invalid or unrecognized. 


INVALID PASSWORD 


Password is invalid. 
I /O-ERR 


A device/file being accessed by MIM is returning a nonzero 
I/O status. 
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I/O-ERR TYPE=DU 


The device is unavailable. 


I/O-ERR TYPE=EOM I[/O-ERR TYPE=EOF 


The device reached an end of medium (EOM) or end of file 
(EOF) before completing the operation. 


I/O-ERR TYPE=FUNC 


An invalid operation is being directed toward a device; e.g., 
attempting to write to a read-only device. 


I/O-ERR TYPE=LU 


The lu is illegal or unassigned. 


I/O-ERR TYPE=PRTY 


A parity or other recoverable error occurred. 


I/O-ERR TYPE=UNRV 


An unrecoverable error occurred. 


JOBS -ERR 


A $JOB statement was encountered following another §JOB 
statement, but prior to a $TERMJOB statement. 


JOB NOT FOUND 


The fd of job to be purged is invalid or is not in the batch 
job queue. 


LOAD-ERR TYPE=ASGN 
Load could not be accomplished because the specified fd _ is 


already exclusively assigned or could not be found. 


LOAD-ERR TYPE=DU 


Attempt was made to load from an unavailable device. 
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LOAD-ERR TYPE=I/0 


An I/O error was generated during the load operation. 


LOAD-ERR TYPE=LIB 
The data in the loader information block (LIB) is invalid. 
This error most frequently occurs when an attempt is made to 
load a task that was not built with Link. 

LOAD-ERR TYPE=LOPT 
Task options are incompatible with the system environment 
that attempted to load the task; i.e., attempt to load an 
executive task (e-task) under MTM where e-task loading under 
MTM is not. enabled. 

LOAD-ERR TYPE=MEM 


A load was attempted without enough memory specified for the 
task's work space. 


LOAD-ERR TYPE=MTCB 


The maximum number of tasks specified at sysgen time was 
exceeded. 


LOAD-ERR TYPE=NOFP 


A task requiring floating point support is being loaded, and 
the required floating point option is not supported in the 
system. 


LOAD-ERR TYPE=SEG 


A task requiring a task common area (TCOM) and/or a_ run-time 
library (RTL) is being loaded. The TCOM/RTL is not in the 
system and cannot be loaded. 


LOAD-ERR TYPE=ROIO 


There is an I/O error on the roll volume. 


LOAD-ERR TYPE=RVOL 


There is a roll file allocation or assignment error. 
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LPU#-ERR 


The logical processing unit (LPU) number is out of range 
(allowed 0 to maximum set at sysgen). 


LU-ERR 


LVL- 


An lu specified in an assign statement is invalid. 


ERR 


The number of sysgen CSS levels was exceeded. 


MEMORY ERROR ON DATA FETCH AT XXXXXX 
MEMORY FAULT ADDRESS=XXXxXXX 


Attempt was made to retrieve or to load data from a failing 
memory area on Perkin-Elmer Series 3200 machines. If 
affected memory is within task space and the operating system 
has memory diagnostic support, the affected page is 
automatically marked off, and the following message is 
displayed: 


AFFECTED MEMORY PAGE MARKED OFF AT XXXXXX 


MEMORY ERROR ON INSTRUCTION FETCH AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXX 


A Perkin-Elmer Series 3200 machine attempted to execute an 
instruction from an area of memory that is failing. If 
affected memory is within task space and the operating system 
has memory diagnostic support, the affected page is 
automatically marked off, and the following message _ is 
displayed: 


AFFECTED MEMORY PAGE MARKED OFF AT XXXXXX 


MEMORY PARITY ERROR AT XXXXXX 


An attempt was made to access nonexistent or bad memory on 
Model 7/32 and 8/32 machines. 


MISSING PASSWORD 


Password was omitted. 
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MNEM-ERR 
The command mnemonic entered is unrecognizable Or a 
nonprivileged user attempted to use a command that required 
privileged status. 

NMPS-ERR 
OPTION LPU and NLPU are only valid for the Model 3200MPS 
System. 

NO CMD-BUFF AVAILABLE 
An attempt was made to send a message to a terminal for which 
all command buffers are occupied. 

NOFP-ERR 
No floating point support exists in the system. 

NON EXISTENT SEGMENT ERROR (PST) AT XXXXXX 

MEMORY FAULT ADDRESS=XXXXXX 
An attempt was made to access a memory location greater than 


the maximum valid program address; i.e., an attempt to access 
a memory location outside of the task space. 


NOPR-ERR 


A command was entered that required more parameters’ than 
specified in the command line. 


NSPL-ERR 


An attempt was made to use the SCTASK parameter of the LOAD 
command for a system using a spooler other than SPL/32. 
PACKED FORMAT-SIGN ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXX 
An illegal sign digit was detected in a packed decimal number 
at XXXXXX for Perkin-Elmer Series 3200 machines only. 


PACKED FORMAT-DATA ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXxXX 


A data error was detected in a packed decimal number at 
XXXXXX for Perkin-Elmer Series 3200 machines only. 
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PAIR-ERR 


The single quotation mark (') or double quotation mark (") 
symbols are not matched. 


PARM-ERR 


A command was entered with invalid or missing parameters. 


PRIV-ERR 
The access privilege mnemonic is syntactically incorrect, or 
an MTM user without access privileges tried to access a 
restricted file. 


RENM-ERR TYPE=NAME 


A filename already exists in the volume directory. 


RENM-ERR TYPE=PRIV 
The file/device cannot be assigned for ERW (required to 
perform the rename) because the file/device is currently 

_- assigned to at least one lu. 

RENM-ERR TYPE = PROT 
The protection keys of the file to be renamed are not 
X'OQOO0O0'. 

REPR-ERR TYPE=PRIV 
The file/device cannot be assigned for ERW (required to carry 
out the reprotection) because the file/device is currently 
assigned to at least one lu. 

REQS--ERR 


The REQUIRED operator is not allowed when used with new 
global variables in a $DEFINE command, 


or a syntax error was detected in a REQUIRE operator. 


ROLL-ERR 


The task is currently rolled out. 
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SEGMENT LIMIT ADDRESS ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXX 


An attempt was made to access a memory location within a 
valid mapped segment, but the page number in the segment is 
greater than the largest valid page number for the _ segment; 


i.e€., an attempt to access a memory location outside of the 
task space. 


SEQ-ERR 


A command was entered out of sequence or when the user _ was 
not in the appropriate mode (e.g., CSS call in task-loaded 
mode). 


SIGNON REQUIRED 
An attempt was made to enter a command before signon, 


or there was a mistake in the SIGNON command. 


SKIP-ERR 


An attempt was made to skip beyond the end of a CSS job. 


SPAC-ERR 


Task exceeds established maximum system space. 


SVC ADDRESS ERROR-INSTRUCTION AT XXXXXX 
SVC PARAMETER BLOCK AT XXXXXX 


The address of the SVC parameter block at XXXXXX was 
incorrect. The SVC parameter block must be on a fullword 
boundary. 


SVC6-ERR TYPE=ARGS 


There is insufficient room between UTOP and CTOP to contain 
the start option string. 


SVC6-ERR TYPE=DORM 


A command was issued to a specified task that is dormant. 


SVC6-ERR TYPE=NMSG 


The directed task could not receive a message trap. 


48-043 FOO RO2 D-13 


SVC6-ERR TYPE=PRES 


The directed task is not present in memory. 


SVC6-ERR TYPE=QUE 


The message could not be queued to the directed task. 


TASK-ERR 


A task-related command was entered and there is no currently 
loaded task. 


TIME-ERR 
A task cannot be loaded because the user account’ central 
processing unit (CPU) limit expired. 

UNDEFINED DATA FORMAT FAULT AT XXXXXX 

MEMORY FAULT ADDRESS=XXXXxXX 


An undefined data format/alignment fault was detected at 
XXXXXX for Perkin-Elmer Series 3200 machines. 


USER-ERR 


An invalid userid was entered in a MESSAGE command. 


VOLN-ERR 


The volume specified is not on-line or the volume name _ is 
invalid. 


xXxxX ERROR ON fd SECTOR n 
An I/O error occurred while attempting to initialize sector 


n of file fd. XXXX is the type of error; it may be 
unrecoverable I/O, recoverable I/O or device unavailable. 
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APPENDIX E 
COMMAND SUBSTITUTION SYSTEM (CSS) MESSAGE SUMMARY 


BUFF-ERR 


indicates an expanded command line exceeds the CSS buffer. 
The task skips to $TERMJOB. 


DBUF -ERR 


indicates the operators of a $DEFINE command created a result 
that is greater than 110 characters or the command buffer 
size, whichever is smaller. 


DEFO-ERR 


indicates more than eight characters were specified for a 
keyword or a required name in the REQUIRED operator. 


DEF 1-ERR 


indicates an illegal character is specified in a keyword or 
a required name _ specification. A through Z are the only 
valid characters, and they must be capital letters. 


DEF 2-ERR 


indicates an empty additional keyword after a quote was’ used 
in a SEARCH operator specification. 


DEF 3-ERR 


indicates the specified variable name is already in use. 


DEF 4-ERR 


indicates the REQUIRED operator must be the last operator 
specified in a $DEFINE command. 


DEF 5-ERR 


indicates a divide by zero was attempted. 
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DEF6-ERR 
indicates an arithmetic fault; the result is greater than 
Y'OFFFFFFF'. 

DEF 7-ERR 
indicates a negative hexadecimal value was’ specified. Only 
positive values are allowed. 

FD-ERR 
indicates an illegal or invalid file descriptor (fd), there 
is not enough space to build an fd, or required file support 
is not in the system. The task skips to $TERMJOB. 

FORM-ERR 
indicates a command syntax is invalid. The task skips to 
$TERMJOB . 

GOTO-ERR 
indicates a $LABEL occurred inside an IF block that was not 
active at the time of the $GOTO command. The task skips to 
$TERMJOB. 

I /O-ERR 
indicates an end of file (EOF) was found while skipping to 
$ENDC, an EOF was found before a $ENDB while building a file, 
or a $TERMJOB was found while skipping to $ENDC within a job. 
The CSS skips to $TERMJOB, end of task code is set to 255, 
and the job is ended. 

JOBS—-ERR 
indicates a second $JOB was found before a §$TERMJOB was 
found. 


KEYW-ERR 


indicates a syntax error detected in a keyword, ina keyword 
parameter or a positional parameter appears after a Keyword. 
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LVL-ERR 
indicates the CSS levels required exceed the number 
established at system generation (sysgen) time. 

MNEM-ERR 
indicates the command entered is not recognized. The task 
skips to $TERMJOB. 

NOPR-ERR 


indicates a required operand for a command was not specified. 


PAIR-ERR 
indicates the single quotation mark (') or double quotation 
mark (") symbols are not matched. 

PARM-ERR 
indicates a command was entered with invalid or missing 
parameters or a variable number is not in allowed range. 

REQS-ERR 
indicates REQUIRED operator is not allowed when used with new 
global variables in a $DEFINE command, or a syntax error was 
detected in a REQUIRE operator. 

SEQ-ERR 
indicates a command was entered out of sequence or a 
privileged command was used by a nonprivileged user. 

TASK-ERR 
indicates a task-related command was entered and there is no 
currently loaded task. The task skips to $TERMJOB. 

%REP-ERR 
indicates invalid replacement string definition or more than 


four replacement strings were defined in a single character 
replacement command. 
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@SYSXXXX VARIABLE ERROR, ILLEGAL NAME 
indicates that a variable was defined beginning with the 
reserved characters @SYS or an attempt was made to freea 
system variable. 

@XXXX-VARIABLE ERROR, ALREADY EXISTS 
indicates an attempt was made to define a local variable that 
already exists. 


@XXXX-VARIABLE ERROR, EXCEEDS USER LIMIT 


indicates that the variable limit set at sysgen was exceeded. 


@XXXX-VARIABLE ERROR, DEFINITION TOO LONG 
indicates that the length of the defined variable is greater 
than 32. 
@XXXX-VARIABLE ERROR, DOES NOT EXIST 
indicates an attempt to set, free or access the value of a 
~nonexistent variable. Also, during CSS execution, a variable 
definition is required. 
@XXXX-VARIABLE ERROR, DEFINITION DOES NOT EXIST 
indicates an attempt to set the value of a variable to the 
value of a second nonexistent variable. 
@SYSCODE-VARIABLE ERROR, UNABLE TO ACCESS PAGE-F ILE 
indicates that at signon time multi-terminal monitor (MTM) 
was unable to access the variable page file. 
VARIABLE ERROR, VARIABLE PROCESSING NOT SUPPORTED 
indicates that one of the following variable-related commands 


was entered into a system that does not support variable 
processing: 


- §FREE 
-  $GLOBAL, 
~ $LOCAL 
- $§SET 
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VARIABLE ERROR, VARIABLE PROCESSING DISABLED 


indicates that one of the following variable-related commands 
was entered into a system with variable processing support 
that is disabled: 


- §FREE 

- $GLOBAL 
- LOCAL 
- $§SET 
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APPENDIX F 
PROGRAM DEVELOPMENT MESSAGE SUMMARY 


ADD requires at least one argument 


indicates a filename was not specified with the ADD command. 


CANNOT RUN -- filename.TSK DOES NOT EXIST 
indicates a filename specified with the EXEC command does not 
exist in the environment. 

Compile css COMPext.CSS does not exist 
indicates the filename entered with the ADD command contains 
a nonstandard extension. 

Current multimodule environment is edfname.EDF 
indicates the ENV command was entered without a parameter, or 
the LIST command causes the contents of the current 
environment to be displayed. 

Deleting filename because it contains no records 
indicates the EDIT command was entered, no text was allocated 
and the END command was entered. This file has been deleted. 

Enter name of file to be edited or * to just start EDITOR 

GIVE FILENAME= 
indicates the EDIT commanagd was’ entered with no filename. 
Entering a space bar and (CR) will enter the EDITOR with no 
file (in append mode). 


Environment edfname.EDF contains no files 


indicates the LIST command was’ entered, but there are no 
filenames in the environment. descriptor file (EDF). 
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Environment name must have no extensions or .EDF 
indicates a filename was specified with the ENV command with 
an invalid extension. 

Execution of filename follows: 


indicates an image program was loaded and is executing. 


FILENAME already exists in environment edfname.EDF 
indicates an attempt was made to add an already existing 
filename to the EDF. 
FILENAME Compilation errors - listing on (device): 
indicates errors were encountered while compiling. These 
errors are listed on the specified device. FILENAME 
indicates the source file containing errors. 


FILENAME is not a valid file descriptor 


indicates an invalid filename form was specified in an ADD, 


. COMPILE or REMOVE command. 


Filename must be specified or current program established 
before compilation 


indicates the COMPILE command was entered with no filename or 
current program. 
FILENAME not found in environment edfname.EDF 
indicates the filename was not found in the _ specified 
environment. 
Filename to be linked must be specified or there must he a 
current program for LINK to work on. 
indicates the LINK, EXEC or COMPLINK command was entered with 
no filename or current program. 
First argument filename is not permitted when in a multimodule 


environment. Environment name is always used. 


indicates a filename was specified where it was not required 
or allowed. 
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Link errors -- listing on (device): 
indicates errors were encountered while linking. These 
errors are listed on the specified device. 

Must be in multimodule environment to use (command) 
indicates a development command such as COMPILE, COMPLINK, 
EXEC or LIST was entered without first setting the 
environment to a multimodule environment. 

Must have current program or specify file in order to run 
indicates the RUN command was’ entered when no current 
environment is set. 

Must specify extension or compile css name 
indicates the ADD command was entered along with a filename 
and no extension. 

New multimodule environment is edfname.EDF 


indicates a new multimodule environment has been allocated. 


No current environment 


indicates a filename was not. specified with the ENV command. 


REMOVE requires one argument 


indicates a filename was not specified with the REMOVE 
commana . 
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APPENDIX G 
MULTI-TERMINAL MONITOR (MTM) /NON-MTM MONITOR 
TASK INTERFACE MESSAGES 


G.1 $FOREGROUND TASK INTERFACE MESSAGES 


The following messages are output to the system console: 
XXXX-ERR SNDTID = sender task-id MSGE: received message 
Where: 
XXXX can be any of the following error statuses: 


@ PARM indicates bad syntax in terminal-dn. 


e TNEX indicates the specified terminal-dn is 
not known by MTM. 


@e TNCM indicates the terminal is not in 
correct mode. 


e TASE indicates a terminal assign error. on 
an $END message (still assigned to 
FOREGROUND task?) . 


e DSTA indicates a duplicate $STA message for 
the same terminal-dn was received. 


@ DEND indicates a duplicate $END message for 
the same terminal-dn was received. 


e MSTA indicates a missing $STA message. 


@e MEND indicates a missing $END message. 
The following messages are output to the user console: 


MNEM-ERR 


interface is not available for normal MTM users. 
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MOSQ-ERR 


mode sequence error occurred; the terminal is not in 
normal MTM mode. 


NTSK-ERR 


selected task is not in foreground or restricted task 
name. 


SEQ-ERR 


indicates task-loaded, task-executing, command 
substitution system (CSS) or batch mode. 


SMGS -ERR 


sends message error. 


#MST-ERR 


$STA message from FOREGROUND task is missing; the 
terminal was reassigned. 


#MEN—-ERR 


$END message from FOREGROUND task is missing; the 
terminal was reassigned. 


TASE-ERR 


indicates a FOREGROUND task assign error. 


TSPC-ERR 
indicates a FOREGROUND task has no more space to add to 
the user's terminal; try again later. 
G.2 HASP INTERFACE MESSAGES 


MNEM-ERR 


a nonprivileged user entered the $HASPxx command or no 
HASP-TUB was generated at MTM system generation (sysgen) 


time. 
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SEQ-ERR 


terminal is in CSS, batch, task-loaded or task-executing 
mode. 


NTSK-ERR 


no such HASPxx taskid was found in the foreground. 


USED-ERR 


the selected HASPxx is currently being used by another MIM 
user. 


TSPC-~ERR 


no HASP-TUB is available (there are more HASP tasks than were 
specified by SGN.$HSP at MTM sysgen time). 


SMGS—-ERR 


indicates an error on the sending message to HASPxx. 


48-043 FOO RO2 G-3 


APPENDIX H 
CONTROL SUMMARY FOR BIDIRECTIONAL INPUT/OUTPUT 
CONTROL (BIOC) CRT DRIVER 


BIOC is a standard OS/32 terminal driver. Listed in this 
appendix are function control codes for the BIOC, the standard 
control characters generated by the use of the codes and the 
functions performed. On terminals that do not generate standard 
control characters for any of the function keys, it is necessary 
to determine which key will produce the required control 
characters in order to invoke a desired function. 


When a combination of the control key and an ASCII key cannot be 
accepted, BIOC will reject that combination and respond with a 
bell code. An example of this would be a cancel request (CTRL-X) 
on a line that has no character on it. ASCII control characters 
for the BIOC will not be echoed (displayed to the console) to 
prevent confusion between BIOC functions and terminal functions. 


ASCII READ MODE: 


CTRL-A (SOH) Adjust Baud Rate 


The baud rate adjust function must be enabled by the system 
programmer before the CTRL-A can be used. When connection to 
a terminal is made over a dial-up line, the adjust baud rate 
mode is automatically entered. 


To change the baud rate on a Perkin-Elmer Model 1200 


terminal, locate the front panel and remove the cover. It is 
important to know which baud rates have been made available 
to your terminal at system generation (sysgen) time. When 


this is known, depress CTRL-A and then change the baud rate 
setting inside the panel, using the scale depicted on _ the 
inside of the ‘panel cover (see Figure H-1). By depressing 
the carriage return (CR) key repeatedly, the user will 
synchronize communication at the new baud rate. BIOC then 
responds with an asterisk (*) and continues with the mode 
that was in use at the time the adjust routine was begun. 
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FULL 
w 
™ 


HALF 


BAUD RATE DUPLEX PARITY 


Figure H-1 Perkin-Elmer Model 1200 Mode Selectors 


CTRL-B (STX) Backspace (Nondestructive) 


This code causes the cursor to backspace one character for 
each time the code is used. To be effective, CTRL-B cannot 
be entered at the first character position ona line. When 
the cursor has been - backspaced to the desired character 
position, the line can be changed by typing the desired 
characters. All other characters backspaced over can be 
restored and the cursor brought back to the end of the _ line 
in one of two ways: 


e@ CTRL-F moves the cursor forward one character at a time. 


e CTRL-Z moves the cursor immediately to the end of the 
line. 


CTRL-C (ETX) Capture the Last Line Entered 


Entering this code will cause the last line entered (maximum 
of 80 characters) to be displayed on the console. By using 
CTRL-C repeatedly, character strings can be concatenated. If 
an insert or delete function is performed, the CTRL-C code 
will be rejected and a bell will sound to remind you that the 
buffer has now been overwritten. CTRL-C will also be 
rejected if the display of data to the console has been 
suppressed by the use of CTRL-E. 


CTRL-D (EOT) Device Control -- Echo Only 


The next character entered after the CTRL-D code will be 
echoed to the terminal but will not be stored in the input 
buffer. This function could be helpful, for example, if an 
auxiliary peripheral is used that requires certain control 
characters to be entered at the console. The CTRL-D code 
would prevent the peripheral control characters from being 
interpreted as program input. 
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CTRL-E (ENQ) Echo Toggle 


Each entry of CTRL-E will change the current echo state from 
ON to OFF or from OFF to ON. This means that data display to 
the console screen can be controlled. Suppression of data 
display is useful for entering passwords without others being 
able to observe them. All functions will work with echo off 
except CTRL-C, CTRL-R, CTRL-W, CTRL-], CTRL-A and CTRL-_.. A 
CTRL-M (CR) buffer full or CTRL-X will turn echo back on. A 
CTRL-E will be rejected if the insert mode is selected. 


CTRL-F (ACK) Forward Space and Restore 


This code is used to restore a line that has been backspaced 
over by the CTRL-B, CTRL-W or CTRL-] code. After the cursor 
has been moved to the desired position and the correction has 
been made, CTRL-F will move the cursor forward one character 
position at a time until it reaches the end of the line. 
CTRL-F will be rejected if there are no characters to be 
restored. 


‘CTRL-H (BS) Backspace (Destructive) 


This code is used to delete a character or characters. 
Unlike CTRL-B, any character(s) backspaced over by using the 
the CTRL-H code cannot be restored by using the CTRL-F or 
CTRL-Z codes and must be retyped. If they are not retyped, 
blank spaces will appear in those character positions. 
CTRL-H will be rejected if attempted at the first character 
position in a line. On most terminals, the CTRL-H code _ can 
be generated by the backspace key. 


CTRL-L (FF) Set Page Pause Line Count 


To set the CRT screen display for a specific number of lines, 
the CTRL-L code is entered, followed by depressing the 
control key again with another ASCII character. The numeric 
value of the ASCII character will set the number of lines’ to 
be displayed. To select a count for a 24-line CRT, enter the 
sequence: CTRL-L, CTRL-X (X has a decimal value of 24). 


The following table shows the proper combinations for _ line 
displays ranging from 1 to 24. 
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TABLE H-1l LINE DISPLAY 


COMBINATIONS 
| NUMBER |} 
! SEQUENCE ' OF LINES } 
| BEV EMWEBVUWBBBEBCECBESTESBTEATs Tz \ 
! CTRL-L CTRL-A | 1 
! CTRL-L CTRL-B | 2 
! CTRL-L CTRL-C | 3 
' CTRL-L CTRL-D } 4 
' CTRL-L CTRL-E } 5 
' CTRL-L CTRL-F | 6 
' CTRL-L CTRL-G } 7 
! CTRL-L CTRL-H } 8 
' CTRL-L CTRL-I | 9 
! CTRL-L CTRL-J } 10 
! CTRL-L CTRL-K } ll 
' CTRL-L CTRL-L | 12 
! CTRL-L CTRL-M | 13 
' CTRL-L CTRL-N } 14 
' CTRL-L: CTRL-O } 15 
'- CTRL-L CTRL-P | 16 
! CTRL-L CTRL-Q } 17 
| CTRL-L CTRL-R | 18 
! CTRL-L CTRL-S | 19 
! CTRL-L CTRL-T } 20 
! CTRL-L CTRL-U } 21 
! CTRL-L CTRL-V } 22 
! CTRL-L CTRL-W } 23 
| CTRL-L CTRL-X | 24 


Each display of the requested number of lines is terminated 
with a bell sound. At this point, the user may continue to 
the next page by entering a CR. This will cause the same 
number of lines to appear; each CR will produce that number 
of lines until the page pause line count is changed. To 
change the count, terminate write by entering ESC or Break 
and enter a different sequence for the desired new line count 
(e.g., CTRL-L CTRL-O = 15 lines, etc.). 


To cancel the page pause mode, use the sequence CTRL-L 
CTRL-@. If the page pause mode is not terminated within 5 
minutes, BIOC will automatically continue output to prevent 
the terminal from being permanently tied up. 
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CTRL-M (CR) Terminate Read 


This function is a CR. Entering CTRL-M indicates to BIOC 
that read should be terminated. If CTRL-M is entered ata 
location other than the end of the line, BIOC will perform a 
move to the end of the line before’ storing the CR and 
terminating the read request. 


CTRL-N (SO) Neutralize Selected Options Back to Default 


This code is entered to reset options back to their default 
values. CTRL-N can be entered during read operations, during 
write operations or between read and write operations. 
Entering CTRL-N performs the following functions: 


@e Resets page pause to zero. 
@ Resets backspace prompt character to CTRL-H. 
@ Resets ASCII read prompt character to sysgen default. 


@ Resets backspace and carriage return/line feed (CR/LF) 
protocol to sysgen default. 


@ Resets output mode to print-on state. 


CTRL-O (SI) Toggle Output Between Print-on and Print-off 


To suppress output in the write mode, CTRL-O is’ used. To 
resume output, this code is used again. Alternately 
depressing CTRL-O will cause output to terminate and resume; 
hence, the toggle characteristic. When using CTRL-O to 
select the print-off mode, a prompt can be _ immediately 
received by a terminate read (CTRL-M). If this is not done 
within 15 seconds after output ceases, BIOC will prompt = and 
reinstate the print-on mode automatically. The print-on mode 
will also be reinstated upon a successful completion of a 
read request or upon entering CTRL-N for a neutralize 
function. 


CTRL-P (DLE) Set ASCII Read Prompt Character 


By entering CTRL-P and any ASCII character, that character 
becomes the designated prompt. When making the selection, 
the ASCII character is not displayed to the console, but is 
output by BIOC upon receipt of an ASCII read request. The 
read prompt function can be turned off by the sequence CTRL-P 
CTRL-X. To reset the ASCII read prompt character to the 
sysgen default, enter CTRL-N. 
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CTRL-Q (DC1) Removed from Input to Allow X-ON/X-OFF Flow Control 


CTRL-R (DC 2) Reprint Entered Line 


When this code is entered, the current cursor location within 
the line will determine the number of characters that will be 
reprinted on the next line. All characters, including blank 
spaces, to the left of the cursor will be reprinted. The 
CTRL-R function will be rejected if the echo state is turned 
off (see CTRL-E). 


The CTRL-R function is especially useful for hardcopy 
terminals where corrections are made over the existing typed 
lines. To view a clean line after all corrections have been 
made, CTRL-R is used. 


CTRL-S (DC 3) Removed from Input to Allow X-ON/X-OFF Flow Control 


CTRL-T (DC4) Single Character Transparent Mode 


The use of this code will allow the entry of function control 
characters into the input buffer. The next character entered 
after a CTRL-T will be entered directly into the input 
buffer. 


CTRL-W (ETB) Word Backspace (Nondestructive) 


CTRL-W causes the cursor to be backspaced (nondestructively) 
to the nearest nonalphabetic character. Thus, CTRL-W allows 
the cursor to backspace over one complete word, rather than 
one character, as with CTRL-B. Words backspaced over may be 
restored by the use of CTRL-F or CTRL-Z. CTRL-W will be 
rejected if attempted at the beginning of a line. 


CTRL-X (CAN) Cancel Current Input Line 


All characters previously entered on the current line will be 
deleted upon use of the code. Characters cannot be restored 
with the CTRL-F or CTRL-Z functions. If no characters are on 
the line, CTRL-X will be rejected. CTRL-X will turn echo 
back on if it has been turned off with CTRL-E. 


CTRL-Z (SUB) Move to Furthest End of Line 
CTRL-Z can be used to restore a line that has been backspaced 
over by CTRL-B, CTRL-W, or CTRL-]. CTRL-Z will cause the 


cursor to move to the end of the line, but will be rejected 
if there are no characters to be restored. 
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CTRL-] (GS) Backward Character Search (Nondestructive) 


This code serves to locate a specific character on the 
current line. For example, to find the character $, enter 
CTRL-]$. BIOC will backspace until the first $ is found. To 
find any additional dollar signs on the same line, the code 
must be entered again for each time the $ symbol appears. 
Characters backspaced over can be restored by using CTRL-F or 
CTRL-Z. CTRL-}] will be rejected if attempted at the 
beginning of the line. 


CTRL-A (RS) Toggle Between Insert-on and Insert-off 


Each CTRL-A toggles from insert-on to insert-off or from 
insert-off to insert-on. When the insert mode is selected, 
characters typed will be inserted in front of the character 
currently over the cursor. The insert mode may be selected 
only when the cursor is positioned at a location other than 
the end of the line and the echo state is on. The insert 
mode will be terminated by another CTRL-A or by any command 
that takes the cursor position to the end of the line (e.g., 
CTRL-Z). The CTRL-C and CTRL-E functions are not valid while 
in the insert mode. All other functions are valid if the 
cursor is not in motion. All data entered while the cursor 
is in motion will be ignored until the cursor has stopped. 


CTRL-_ (US) Delete Character 


Each CTRL-_. deletes the character currently over the cursor. 
The delete code is valid only when the cursor is positioned 
at a location other than the end of the line and the echo 
state is. on. Characters entered while the cursor is in 
motion will be ignored. 


WRITE MODE: 


BREAK 


This key terminates write with the break status. 


ESC 


This key terminates write with the break status. 
CTRL-Q 


This code resumes write after write has been suspended by 
CTRL-T or CTRL-S functions. 
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CTRL-R 
This code 
CTRL-T or 
CTRL-S 
This code 
CTRL-Q or 
CTRL-T 


This code 
CTRL-Q or 


resumes write after write 
CTRL-S functions. 


suspends write until write 
until the BREAK or ESC key 


suspends write until write 
until the BREAK or ESC key 


has 


is 
is 


is 
is 


been suspended by 


resumed by CTRL-R or 
depressed. 


resumed by CTRL-R- or 
depressed. 
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CSS file (Continued) 
ACCOUNT operator 
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ASSIGN command 2-6 $SKIP 6-61 
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Scene opereter san. euancomee” ce 
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else ee ee system. | CURRENT operator 6-41 
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Commands executable within a 
cSS file 6-16 | D 
$BUILD and $ENDB 6-22 | 
serene oe ! DCOMPUTE operator 6-34 
% | $DEFINE command 6-27 
SDEF INE 6-27 3 conversion operators 6-34 
$EXIT 6-49 3 fd operators 6-28 
$F REE 6-50; LOGICAL operators 6-33 
$GLOBAL 6-51 other operators 6-40 
$JOB and $TERMJOB 6-52 ' DELETE command 2-21 
$LOCAL 6-54 | DHCONVERT operator 6-36 
i DISPLAY ACCOUNTING command 2-24 
i DISPLAY command 2-22 
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DISPLAY DEVICES command 
DISPLAY DFLOAT command 
DISPLAY FILES command 
DISPLAY FLOAT command 
DISPLAY LU command 

DISPLAY PARAMETERS command 
DISPLAY REGISTERS command 
DISPLAY TIME command 
DISPLAY USERS command 
DVOLUMENAME operator 


a7} 


EDIT command 
$ELSE command 
ENABLE command 
End of task code testing 
commands 
$IFE 
$IFG 
$IFL 
$IFNE 
$IFNG 
$IFNIL 
ENV command 
Establishing a CSS file 
EXAMINE command 
EXEC command 
Executing 
a program 
multiple programs 
$EXIT command 
EXTENSION operator 


fd operators 
ACCOUNT 
EXTENS [ON 
F [LENAME 
VOLUMENAME 
FFILE command 
File conventions 
fds 
group account numbers 
private account numbers 
system account numbers 
File descriptor. See fd. 
File existence testing 
commands 
S$IFNX 
$IFX 
FILENAME operator 
FRECORD command 
$FREE command 


G 


$GLOBAL command 
$GOTO and $LABEL commands 


H 
HASP interface 


HCOMPUTE operator 
HDCONVERT operator 
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HELP command 
Help Facility 


I 


$IF...EQUAL, $IF...NEQUAL 
commands 

$IF...GREATER, 
$IF...NGREATER commands 

$IF...LESS, $I1F...NLESS 
commands 

$IFEXTENSION command 

$1FVOLUME command 


INIT command 


/@INPUT control statement 
Input spooling 
Input spooling control card 
statements 
/@INPUT control 
/@SUBMIT control 
INQUIRE command 
Integrated transaction 
controller. See ITC. 
Interactive environment 
Interfacing with a 
foreground task 
programming details 
ITC/RELIANCE interface 


J,K 


$JOB and $TERMJOB commands 


L 


LINK command 

link sequences 
LIST command 
LOAD command 
Loading a task 
$LOCAL command 
LOG command 


Logical IF commands 
$ELSE 
$GOTO and $LABEL 
$ I FEXTENS ION 
$ [F VOLUME 
end of task code testing 
file existence testing 
parameter existence 
testing 

Logical IF commands 

comparing two arguments 


$IF...EQUAL 
$IF...GREATER 
$IF...LESS 


$IF...NEQUAL 

$IF...NGREATER 

$IF...NLESS 
LOGICAL operators 


M,N 
MESSAGE command 


MODIFY command 
Modifying a program 
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MTM 
basic MTM terminal 


MTM user commands 
(Continued) 


{ 
t 
session 27% H PUNCH 2-69 
batch processing 5=1 } RENAME 2-72 
command summary A-1 ' REPROTECT 2-73 
conventions 1-9 H REWIND and RW 2-74 
devices 1-3 | RVOLUME 2-95 
functions l=. H SEND 2-78 
loading a task L=7 H SET GROUP 2-79 
message summary Dad H SET KEYOPERATOR 2-81 
multiprocessor ' SET PRIVATE 2-83 
env ironment 1-6 } SIGNOFF 2-85 
operation LL H SIGNON 2-86 
special features L=7 H SPOOLF I LE 2-90 
subtask environments 1-4 H START 2-93 
task interfaces 3-1 ' TASK 2-95 
terminal modes Les | TEMPF ILE 2-96 
user commands 21 H VOLUME 2-100 
MTM special features ep j WF ILE 2-102 
css 1-8 H XALLOCATE 2-103 
Help Facility 1-8 { XDELETE 2-106 
program development | MTM/non-MTM task interface 
commands L=8 H messages G-l 
security and access | Multi-terminal monitor. See 
protection of disks 1-8 ' MTM. 
signon CSS L=9 | Multiprocessor environment 
spooling 1-8 ' APU 1-6 
MTM user commands 2-1 ' CPU 1-6 
$RELEASE 2-70 |} load-leveling i a 
ALLOCATE 2-2 H 
ASSIGN 2-6 | 
BF ILE 2712. 4 O 
BIAS 2-13 | 
BREAK 2-14 |; OPTIONS command 2-63 
BRECORD 2-15 ; OS/32 Spooler 7-1 
BUILD AND ENDB 2-16 } input spooling 7-2 
CANCEL 2-18 | input spooling control 
CLOSE 2-19 | card statements 7-2 
CONT [NUE 2-20). \y spooling errors 7-6 
DELETE 2-21 {| Other operators 
DISPLAY 22220 +4 CLEAR 6-40 
DISPLAY ACCOUNTING 2-24 | CURRENT 6-41 
DISPLAY DEVICES 2-27 $ DVOLUMENAME 6-42 
DISPLAY DFLOAT 2-29 | REQUIRED 6-43 
DISPLAY FILES 2-30 |} SEARCH 6-44 
DISPLAY FLOAT 2-36" —| STRING 6-47 
DISPLAY LU 2-37 {| Output spooling 7-5 
DISPLAY PARAMETERS 2-38 |} 
DISPLAY REGISTERS 2-44 | 
DISPLAY TIME 2-45 | P,Q 
DISPLAY USERS 2-46 |} 
ENABLE 2-47 {| Parameter existence testing 
EXAMINE 2-49 \ commands 
FF ILE 2-51 | $ I FNNULL 6-66 
FRECORD 2-52 | $ I FNULL 6-66 
HELP 2-53 {| Parameters 6-A 
INIT 2-55 } keyword 6-8 
LOAD 2-56 } positional 6-5 
LOG 2-58 {| PASSWORD command 2-65 
MESSAGE 2-60 {| PAUSE command 2-66 
MODIFY 2-61 | §PAUSE command 6-55 
OPTIONS 2-63 | PREVENT command 2-67 
PASSWORD 2-65 {| PRINT command 2-68 
PAUSE 2-66 {| PRIOR command 6-56 
PREVENT 2-67 {| Privileged users L383 
PRINT 2-68 |} 
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Program development 
assigning logical units 
commands 
creating a source 
error recovery 
executing a program 
executing multiple 

programs 
language commands 
modifying a program 
reexecuting a modified 
program 
sample session 

Program development command 

summary 

Program development commands 


ADD 

COMP [LE 
COMPLILINK 
EDIT 


Program development language 
commands 
Program development message 
summary 
Programs 
creating source 
executing 
executing multiple 
modifying 
reexecuting 
Prompt conventions 
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